FULLSCREEN CONTENTS Project Home Page
.OUT_FORMATS.: /O (fixed) output date formats
.ALIAS.......: OUDAFO2
.DISCUSSION..:
This set of fixed formats has been largely been replaced by the /C format introduced in FDATE version 10. It is documented here for backward compatibility, and some of the "canned" formats (e.g. /oFULL) that may still be useful. see OUT_FORMATS /C (customized) output date formats


.EXAMPLES:

  FORMAT        EXAMPLES      COMMENTS
  ------        ---------     -----------------------------
  dd-mn3-yy     08-Feb-92     CompuServe-style date
    yy            93          2-digit year number
  ccyy          1993          4-digit year number (includes century)
  ccyymm        199302        useful for triggering monthly processing
  ccyymmdd      19930208      useful for putting current date in filename
    yymmdd        930208      PKZIP's Japanese date format
      mmdd          0208
       mmddyy      020892    PKZIP's American date format
       mmddccyy   02081992
        mm            02      2-digit month number
        zm             2      month number, no leading zeros
        dd            08      2-digit day-of-month number
        zd             8      day-of-month number, no leading zeros

  In the following formats, months precede days (American style)
  ------------------------------------------------------------------
  mm/dd/ccyy    02/08/1993
  mm-dd-ccyy    02-08-1993
  mm.dd.ccyy    02.08.1993    British-style dates

  zm/zd/ccyy     2/8/1993     no leading zeros in day or month
  zm-zd-ccyy     2-8-1993     no leading zeros in day or month
  zm.zd.ccyy     2.8.1993     British-style dates

  mm/dd/yy      02/08/92
  mm-dd-yy      02-08-92
  mm.dd.yy      02.08.92      British-style dates

  zm/zd/yy       2/8/92       no leading zeros in day or month
  zm-zd-yy       2-8-92       no leading zeros in day or month
  zm.zd.yy       2.8.92       no leading zeros in day or month


  In the following formats, days precede months  (European style)
  ------------------------------------------------------------------

  ddmmccyy      02081993
     ddmmyy        020893PKZIP's European date format

  dd/mm/ccyy    02/08/1993
  dd-mm-ccyy    02-08-1993
  dd.mm.ccyy    02.08.1993    British-style dates

  zd/zm/ccyy     2/8/1993     no leading zeros in day or month
  zd-zm-ccyy     2-8-1993     no leading zeros in day or month
  zd.zm.ccyy     2.8.1993     British-style dates

  dd/mm/yy      02/08/93
  dd-mm-yy      02-08-93
  dd.mm.yy      02.08.93      British-style dates

  zd/zm/yy       2/8/93       no leading zeros in day or month
  zd-zm-yy       2-8-93       no leading zeros in day or month
  zd.zm.yy       2.8.93       British-style dates

  DAY-OF-WEEK AND MONTH OUTPUT FORMATS
  ====================================

  dow#           5            Sunday=1, Monday=2 .... Saturday=7.

  dow            Thursday     name of day of week
                 jeudi        if /Lfr specified
                 Donnerstag   if /Lgr specified

  dow3           Thu          first 3 characters of name of day of week
                 jeu          if /Lfr specified
                 Don          if /Lgr specified

  mn             February     name of month
                 fevrier      if /Lfr specified
                 Februar      if /Lgr specified

  mn3            Feb          first 3 characters of name of month
                 fev          if /Lfr specified
                 Feb          if /Lgr specified



  MISCELLANEOUS OUTPUT FORMATS
  ============================

  full      9:05 pm on Wednesday February 5, 1992
            9:05 pm, mercredi le 5 fevrier 1992  [/Lfr specified]
            9:05 pm, mi‚rcoles el 5 de febrero de 1992 [/Lsp specified]
            Mittwoch, 5. Februar 1992, 21:05     [/Lgr specified]

  d1        Saturday, February 5, 1992
            samedi le 5 fevrier 1992      [/Lfr specified]
            Mittwoch, 5. Februar 1992     [/Lgr specified]

  ddmn3yy   05Feb92

  xxx       2CP  (...Dec 25, 1992)
            This format represents dates for the years 1990-2024 in 3
            characters of "extended hex" ("XX") notation.  For more on XX
            notation, see the discussion of the #2XX function.

            The first character is the XX representation of the number of
            years since 1990 (1990 = 0, 1991 = 1, etc.).  If you attempt to
            output a date outside of the 1990-2024 range in XXX format, Fdate
            will report an error (i.e. return "ERROR" and errorlevel of 1).

            The second and third characters contain the XX representation of
            the month-number and day-of-month-number, respectively.

            EXAMPLE: "1993 Feb  1"  is represented as  "321"
            EXAMPLE: "2000 Dec 25"  is represented as  "ACP".

  -----------------------------------------------------------------------
  NOTE that the following formats contain embedded spaces.  Consequently
  they must be enclosed in double quotes. EXAMPLE: /O"mn zd, ccyy".
  -----------------------------------------------------------------------
  "zd mn ccyy"      5 February 1992
  "zd mn, ccyy"     5 February, 1992
  "zd. mn ccyy"     5. February 1992   [German-style date format]
  "zd. mn3 ccyy"    5. Feb 1992        [German-style date format]
  "mn3 dd ccyy"     Feb 05 1992
  "mn3 dd, ccyy"    Feb 05, 1992
  "mn zd, ccyy"     February 5, 1992



  LEAP-YEAR FLAG OUTPUT FORMAT
  ============================

  LY              0     "1" if date occurs in a leapyear, otherwise "0".

                   365 + this number gives total number of days in the year.
                    28 + this number gives total number of days in February.




  TIME OUTPUT FORMATS
  ===================
  See also: the section on the /T (parm /A time override) parameter.

  t1            9:05 am
                9:05 pm

  tdos          9:05:10:10a     format used in DOS's TIME command
                9:05:10:10p

  HH:MM        09:05      24-hour time, hours:minutes
               21:05
  HHMM         0905
               2105

  HH:MM:SS     21:05:30   24-hour time, hours:minutes:seconds
  HHMMSS       210530

  HH:MM:SS:CC  21:05:30:09   24-hour time, in
  HHMMSSCC     21053009      hours:minutes:seconds:hundredths of seconds


  BUSINESS JULIAN DATE OUTPUT FORMATS
  ===================================

  These are formats for "business julian" dates: dates expressed as the
  number of days from the beginning of the year, when January 1 is day 1.

  EXAMPLES:

        DATE      BUSINESS JULIAN DATE
    -----------   --------------------
    Jan  5, 1993  93005
    Dec 31, 1993  93365  [Dec 31 is 365th day of year 1993]
    Dec 31, 1996  96366  [Dec 31 is 366th day, because 1996 is a leap year]


  FORMAT        EXAMPLES      DISCUSSION
  ------        ---------     -----------------------------

  ccyyjjj       1992027       Jan 27, 1992
    yyjjj         92027       "Business Julian" date expressed as number
      jjj           027       of days since January 1 of the same year.
      zzj            27       Note leading zero suppression in "zzj".


  ABSOLUTE DATE/TIME OUTPUT FORMATS
  =================================
  See also: the section on the /T (parm /A time override) parameter.


  month#          23927      "Absolute month": date expressed as number of
                             months since the beginning of the calendar.
                             Returns "1" for any date in January, 0001, "2"
                             for any date in February, 0001, etc.

  day#           727198      "Absolute date": date expressed as number of
                             days since the beginning of the calendar.
                             Returns "1" for January 1, 0001, "2" for
                             January 2, 0001, etc.

  minute#         33088       "Absolute minutes": time expressed as number
                              of minutes  since midnight, January 1, 1990.

  second#        633088       "Absolute seconds": time expressed as number
                              of seconds  since midnight, January 1, 1990.


  Running FDATE with /O parameter for an "absolute time" produces a
  number based on the current time of day and the date in the /A parm.

  If, on January 10, 1992 at 2 pm, you run FDATE this way:
         FDATE /Ff /Atoday /Ominute#
  it will produce the absolute minute for January 10, 1992 at 2 pm.

  If, on January 10, 1992 at 2 pm, you run FDATE this way:
         FDATE /Ff /A01-15-1992 /Imm-dd-ccyy  /Ominute#
  it will produce the absolute minute for January 15, 1992 at 2 pm.