"Fossies" - the Fresh Open Source Software Archive

Member "dateutils-0.4.6/info/dseq.texi" (19 Mar 2019, 7753 Bytes) of package /linux/privat/dateutils-0.4.6.tar.xz:


Caution: As a special service "Fossies" has tried to format the requested Texinfo source page into HTML format but that may be not always succeeeded perfectly. Alternatively you can here view or download the uninterpreted Texinfo source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field.

[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

1 dseq

dseq may be invoked with the following command-line options:

Usage: dateseq [OPTION]... FIRST [[INCREMENT] LAST]

Generate a sequence of date/times from FIRST to LAST, optionally in steps of
INCREMENT (which defaults to `1d').

If LAST is omitted it defaults to `now' if FIRST is a date/time, or `today' if
FIRST is a date, or `time' if FIRST is a time.

The values of FIRST and LAST are always inclusive and no date/times before
FIRST and no date/times after LAST will be printed.

Negative INCREMENTs must be given, i.e. if FIRST is newer than LAST.

  -h, --help            Print help and exit
  -V, --version         Print version and exit
  -q, --quiet           Suppress message about date/time and duration
                        parser errors and fix-ups.
                        The default is to print a warning or the
                        fixed up value and return error code 2.
  -f, --format=STRING   Output format.  This can either be a specifier
                        string (similar to strftime()'s FMT) or the name
                        of a calendar.
  -i, --input-format=STRING...
                        Input format, can be used multiple times.
                        Each date/time will be passed to the input
                        format parsers in the order they are given, if a
                        date/time can be read successfully with a given
                        input format specifier string, that value will
                        be used.
  -b, --base=DT         For underspecified input use DT as a fallback to
                        fill in missing fields.  Also used for ambiguous
                        format specifiers to position their range on the
                        absolute time line.
                        Must be a date/time in ISO8601 format.
                        If omitted defaults to the current date/time.
  -e, --backslash-escapes
                        Enable interpretation of backslash escapes in the
                        output and input format specifier strings.
      --locale=LOCALE   Format results according to LOCALE, this would only
                        affect month and weekday names.
      --from-locale=LOCALE
                        Interpret dates on stdin or the command line as
                        coming from the locale LOCALE, this would only
                        affect month and weekday names as input formats
                        have to be specified explicitly.
  -s, --skip=STRING...  Skip weekdays specified by STRING.
                        STRING can be a single weekday (Mon, Tue, etc.),
                        and to skip several days the --skip option can
                        be used multiple times.
                        STRING can also be a comma-separated list of
                        weekday names, or `ss' to skip weekends
                        (sat+sun) altogether.
                        STRING can also contain date ranges like `mo-we'
                        for monday to wednesday.
      --alt-inc=STRING  Alternative increment to use when a date is hit
                        that is skipped as per --skip.
                        This increment will be applied until a
                        non-skipped date is reached.
                        The special case `0' (default) deactivates
                        alternative incrementing.  A useful value could
                        be `1d' for increasing sequences and `-1d' for
                        decreasing sequences, so if a skipped date is
                        encountered the next non-skipped date
                        after/before will be used.
      --compute-from-last
                        Compute a start value from LAST using INCREMENT.
                        This option has an effect only when INCREMENT is
                        not a divisor of the duration between FIRST and
                        LAST.  In such case, an alternative FIRST will
                        be computed by consecutively subtracting
                        INCREMENT from LAST until FIRST is hit or
                        crossed.


Report bugs to https://github.com/hroptatyr/dateutils/issues

[ << ] [ < ] [ Up ] [ > ] [ >> ]         [Top] [Contents] [Index] [ ? ]

1.1 Examples

$ dseq 2012-02-01 2012-03-01
2012-02-01
2012-02-02
2012-02-03
2012-02-04
2012-02-05
2012-02-06
2012-02-07
2012-02-08
2012-02-09
2012-02-10
2012-02-11
2012-02-12
2012-02-13
2012-02-14
2012-02-15
2012-02-16
2012-02-17
2012-02-18
2012-02-19
2012-02-20
2012-02-21
2012-02-22
2012-02-23
2012-02-24
2012-02-25
2012-02-26
2012-02-27
2012-02-28
2012-02-29
2012-03-01
$
$ dseq 2001-02-03 2001-03-03 --skip sat -f "%F %a"
2001-02-04 Sun
2001-02-05 Mon
2001-02-06 Tue
2001-02-07 Wed
2001-02-08 Thu
2001-02-09 Fri
2001-02-11 Sun
2001-02-12 Mon
2001-02-13 Tue
2001-02-14 Wed
2001-02-15 Thu
2001-02-16 Fri
2001-02-18 Sun
2001-02-19 Mon
2001-02-20 Tue
2001-02-21 Wed
2001-02-22 Thu
2001-02-23 Fri
2001-02-25 Sun
2001-02-26 Mon
2001-02-27 Tue
2001-02-28 Wed
2001-03-01 Thu
2001-03-02 Fri
$
$ dseq --compute-from-last 2001-02-03 1 2001-03-03 --skip sat -f "%F %a"
2001-02-04 Sun
2001-02-05 Mon
2001-02-06 Tue
2001-02-07 Wed
2001-02-08 Thu
2001-02-09 Fri
2001-02-11 Sun
2001-02-12 Mon
2001-02-13 Tue
2001-02-14 Wed
2001-02-15 Thu
2001-02-16 Fri
2001-02-18 Sun
2001-02-19 Mon
2001-02-20 Tue
2001-02-21 Wed
2001-02-22 Thu
2001-02-23 Fri
2001-02-25 Sun
2001-02-26 Mon
2001-02-27 Tue
2001-02-28 Wed
2001-03-01 Thu
2001-03-02 Fri
$
$ dseq 2001-02-03 3 2001-03-03 --skip sat,fri -f "%F %a"
2001-02-06 Tue
2001-02-12 Mon
2001-02-15 Thu
2001-02-18 Sun
2001-02-21 Wed
2001-02-27 Tue
$
$ dseq --compute-from-last 2001-02-03 3 2001-03-03 --skip sat,fri -f "%F %a"
2001-02-04 Sun
2001-02-07 Wed
2001-02-13 Tue
2001-02-19 Mon
2001-02-22 Thu
2001-02-25 Sun
2001-02-28 Wed
$
$ dseq 2001-02-05 4 2001-03-04 -f "%F %a"
2001-02-05 Mon
2001-02-09 Fri
2001-02-13 Tue
2001-02-17 Sat
2001-02-21 Wed
2001-02-25 Sun
2001-03-01 Thu
$
$ dseq --compute-from-last 2001-02-05 4 2001-03-04 -f "%F %a"
2001-02-08 Thu
2001-02-12 Mon
2001-02-16 Fri
2001-02-20 Tue
2001-02-24 Sat
2001-02-28 Wed
2001-03-04 Sun
$
$ dseq --alt-inc 1d 2001-02-03 3 2001-03-03 --skip sat,fri -f "%F %a"
2001-02-04 Sun
2001-02-07 Wed
2001-02-11 Sun
2001-02-14 Wed
2001-02-18 Sun
2001-02-21 Wed
2001-02-25 Sun
2001-02-28 Wed
$
$ dseq --compute-from-last --alt-inc 1d 2001-02-03 3 2001-03-03 --skip sat,fri -f "%F %a"
2001-02-04 Sun
2001-02-07 Wed
2001-02-11 Sun
2001-02-14 Wed
2001-02-18 Sun
2001-02-21 Wed
2001-02-25 Sun
2001-02-28 Wed
$
$ dseq 2001-01-01 2d 2001-01-08
2001-01-01
2001-01-03
2001-01-05
2001-01-07
$
$ dseq --compute-from-last 2001-01-01 2d 2001-01-08
2001-01-02
2001-01-04
2001-01-06
2001-01-08
$
$ dseq 2001-01-08 -2d 2001-01-01
2001-01-08
2001-01-06
2001-01-04
2001-01-02
$
$ dseq --compute-from-last 2001-01-08 -2d 2001-01-01
2001-01-07
2001-01-05
2001-01-03
2001-01-01
$
$ dseq 10:00:00 12m 11:20:00
10:00:00
10:12:00
10:24:00
10:36:00
10:48:00
11:00:00
11:12:00
$
$ dseq --compute-from-last 10:00:00 12m 11:20:00
10:08:00
10:20:00
10:32:00
10:44:00
10:56:00
11:08:00
11:20:00
$
$ dseq 11:20:00 -12m 10:00:00
11:20:00
11:08:00
10:56:00
10:44:00
10:32:00
10:20:00
10:08:00
$
$ dseq --compute-from-last 11:20:00 -12m 10:00:00
11:12:00
11:00:00
10:48:00
10:36:00
10:24:00
10:12:00
10:00:00
$

[Top] [Contents] [Index] [ ? ]

About This Document

This document was generated on March 20, 2019 using texi2html.

The buttons in the navigation panels have the following meaning:

Button Name Go to From 1.2.3 go to
[ << ] FastBack Beginning of this chapter or previous chapter 1
[ < ] Back Previous section in reading order 1.2.2
[ Up ] Up Up section 1.2
[ > ] Forward Next section in reading order 1.2.4
[ >> ] FastForward Next chapter 2
[Top] Top Cover (top) of document  
[Contents] Contents Table of contents  
[Index] Index Index  
[ ? ] About About (help)  

where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:


This document was generated on March 20, 2019 using texi2html.