Difference between revisions of "Date and Time formatting"

From FileZilla Wiki
Jump to navigationJump to search
 
(Reformatted raw copy/paste of man page into something that looks a little better on the web.)
Line 3: Line 3:
 
Excerpt from the strftime man page:
 
Excerpt from the strftime man page:
  
−
Ordinary characters placed in the format string are copied to s without conversion. Conversion specifications are introduced by a `%' character, and terminated by a conversion specifier character, and are replaced in s as follows:
+
Ordinary characters placed in the format string are copied to s without conversion. Conversion specifications are introduced by a '%' character, and terminated by a conversion specifier character, and are replaced in s as follows:
  
−
%a
+
{| border=1 width=100%
−
    The abbreviated weekday name according to the current locale.  
+
|%a
−
%A
+
|The abbreviated weekday name according to the current locale.  
−
    The full weekday name according to the current locale.  
+
|-
−
%b
+
|%A
−
    The abbreviated month name according to the current locale.  
+
|The full weekday name according to the current locale.  
−
%B
+
|-
−
    The full month name according to the current locale.  
+
|%b
−
%c
+
|The abbreviated month name according to the current locale.  
−
    The preferred date and time representation for the current locale.  
+
|-
−
%C
+
|%B
−
    The century number (year/100) as a 2-digit integer. (SU)  
+
|The full month name according to the current locale.  
−
%d
+
|-
−
    The day of the month as a decimal number (range 01 to 31).  
+
|%c
−
%D
+
|The preferred date and time representation for the current locale.  
−
    Equivalent to %m/%d/%y. (Yecch --- for Americans only. Americans should note that in other countries %d/%m/%y is rather common. This means that in international context this format is ambiguous and should not be used.) (SU)  
+
|-
−
%e
+
|%C
−
    Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space. (SU)  
+
|The century number (year/100) as a 2-digit integer. (SU)  
−
%E
+
|-
−
    Modifier: use alternative format, see below. (SU)  
+
|%d
−
%F
+
|The day of the month as a decimal number (range 01 to 31).  
−
    Equivalent to %Y-%m-%d (the ISO 8601 date format). (C99)  
+
|-
−
%G
+
|%D
−
    The ISO 8601 year with century as a decimal number. The 4-digit year corresponding to the ISO week number (see %V). This has the same format and value as %y, except that if the ISO week number belongs to the previous or next year, that year is used instead. (TZ)  
+
|Equivalent to %m/%d/%y. (Yecch --- for Americans only. Americans should note that in other countries %d/%m/%y is rather common. This means that in international context this format is ambiguous and should not be used.) (SU)  
−
%g
+
|-
−
    Like %G, but without century, i.e., with a 2-digit year (00-99). (TZ)  
+
|%e
−
%h
+
|Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space. (SU)  
−
    Equivalent to %b. (SU)  
+
|-
−
%H
+
|%E
−
    The hour as a decimal number using a 24-hour clock (range 00 to 23).  
+
|Modifier: use alternative format, see below. (SU)  
−
%I
+
|-
−
    The hour as a decimal number using a 12-hour clock (range 01 to 12).  
+
|%F
−
%j
+
|Equivalent to %Y-%m-%d (the ISO 8601 date format). (C99)  
−
    The day of the year as a decimal number (range 001 to 366).  
+
|-
−
%k
+
|%G
−
    The hour (24-hour clock) as a decimal number (range 0 to 23); single digits are preceded by a blank. (See also %H.) (TZ)  
+
|The ISO 8601 year with century as a decimal number. The 4-digit year corresponding to the ISO week number (see %V). This has the same format and value as %y, except that if the ISO week number belongs to the previous or next year, that year is used instead. (TZ)  
−
%l
+
|-
−
    The hour (12-hour clock) as a decimal number (range 1 to 12); single digits are preceded by a blank. (See also %I.) (TZ)  
+
|%g
−
%m
+
|Like %G, but without century, i.e., with a 2-digit year (00-99). (TZ)  
−
    The month as a decimal number (range 01 to 12).  
+
|-
−
%M
+
|%h
−
    The minute as a decimal number (range 00 to 59).  
+
|Equivalent to %b. (SU)  
−
%n
+
|-
−
    A newline character. (SU)  
+
|%H
−
%O
+
|The hour as a decimal number using a 24-hour clock (range 00 to 23).  
−
    Modifier: use alternative format, see below. (SU)  
+
|-
−
%p
+
|%I
−
    Either `AM' or `PM' according to the given time value, or the corresponding strings for the current locale. Noon is treated as `pm' and midnight as `am'.  
+
|The hour as a decimal number using a 12-hour clock (range 01 to 12).  
−
%P
+
|-
−
    Like %p but in lowercase: `am' or `pm' or a corresponding string for the current locale. (GNU)  
+
|%j
−
%r
+
|The day of the year as a decimal number (range 001 to 366).  
−
    The time in a.m. or p.m. notation. In the POSIX locale this is equivalent to `%I:%M:%S %p'. (SU)  
+
|-
−
%R
+
|%k
−
    The time in 24-hour notation (%H:%M). (SU) For a version including the seconds, see %T below.  
+
|The hour (24-hour clock) as a decimal number (range 0 to 23); single digits are preceded by a blank. (See also %H.) (TZ)  
−
%s
+
|-
−
    The number of seconds since the Epoch, i.e., since 1970-01-01 00:00:00 UTC. (TZ)  
+
|%l
−
%S
+
|The hour (12-hour clock) as a decimal number (range 1 to 12); single digits are preceded by a blank. (See also %I.) (TZ)  
−
    The second as a decimal number (range 00 to 60). (The range is up to 60 to allow for occasional leap seconds.)  
+
|-
−
%t
+
|%m
−
    A tab character. (SU)  
+
|The month as a decimal number (range 01 to 12).  
−
%T
+
|-
−
    The time in 24-hour notation (%H:%M:%S). (SU)  
+
|%M
−
%u
+
|The minute as a decimal number (range 00 to 59).  
−
    The day of the week as a decimal, range 1 to 7, Monday being 1. See also %w. (SU)  
+
|-
−
%U
+
|%n
−
    The week number of the current year as a decimal number, range 00 to 53, starting with the first Sunday as the first day of week 01. See also %V and %W.  
+
|A newline character. (SU)  
−
%V
+
|-
−
    The ISO 8601:1988 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week. See also %U and %W. (SU)  
+
|%O
−
%w
+
|Modifier: use alternative format, see below. (SU)  
−
    The day of the week as a decimal, range 0 to 6, Sunday being 0. See also %u.  
+
|-
−
%W
+
|%p
−
    The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01.  
+
|Either 'AM' or 'PM' according to the given time value, or the corresponding strings for the current locale. Noon is treated as 'pm' and midnight as 'am'.  
−
%x
+
|-
−
    The preferred date representation for the current locale without the time.  
+
|%P
−
%X
+
|Like %p but in lowercase: 'am' or 'pm' or a corresponding string for the current locale. (GNU)  
−
    The preferred time representation for the current locale without the date.  
+
|-
−
%y
+
|%r
−
    The year as a decimal number without a century (range 00 to 99).  
+
|The time in a.m. or p.m. notation. In the POSIX locale this is equivalent to '%I:%M:%S %p'. (SU)  
−
%Y
+
|-
−
    The year as a decimal number including the century.  
+
|%R
−
%z
+
|The time in 24-hour notation (%H:%M). (SU) For a version including the seconds, see %T below.  
−
    The time-zone as hour offset from GMT. Required to emit RFC 822-conformant dates (using "%a, %d %b %Y %H:%M:%S %z"). (GNU)  
+
|-
−
%Z
+
|%s
−
    The time zone or name or abbreviation.  
+
|The number of seconds since the Epoch, i.e., since 1970-01-01 00:00:00 UTC. (TZ)  
−
%%
+
|-
−
    A literal `%' character.
+
|%S
 +
|The second as a decimal number (range 00 to 60). (The range is up to 60 to allow for occasional leap seconds.)  
 +
|-
 +
|%t
 +
|A tab character. (SU)  
 +
|-
 +
|%T
 +
|The time in 24-hour notation (%H:%M:%S). (SU)  
 +
|-
 +
|%u
 +
|The day of the week as a decimal, range 1 to 7, Monday being 1. See also %w. (SU)  
 +
|-
 +
|%U
 +
|The week number of the current year as a decimal number, range 00 to 53, starting with the first Sunday as the first day of week 01. See also %V and %W.  
 +
|-
 +
|%V
 +
|The ISO 8601:1988 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week. See also %U and %W. (SU)  
 +
|-
 +
|%w
 +
|The day of the week as a decimal, range 0 to 6, Sunday being 0. See also %u.  
 +
|-
 +
|%W
 +
|The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01.  
 +
|-
 +
|%x
 +
|The preferred date representation for the current locale without the time.  
 +
|-
 +
|%X
 +
|The preferred time representation for the current locale without the date.  
 +
|-
 +
|%y
 +
|The year as a decimal number without a century (range 00 to 99).  
 +
|-
 +
|%Y
 +
|The year as a decimal number including the century.  
 +
|-
 +
|%z
 +
|    The time-zone as hour offset from GMT. Required to emit RFC 822-conformant dates (using "%a, %d %b %Y %H:%M:%S %z"). (GNU)  
 +
|-
 +
|%Z
 +
|The time zone or name or abbreviation.  
 +
|-
 +
|%%
 +
|A literal '%' character.
 +
|}

Revision as of 22:22, 3 July 2008

Format specifiers

Excerpt from the strftime man page:

Ordinary characters placed in the format string are copied to s without conversion. Conversion specifications are introduced by a '%' character, and terminated by a conversion specifier character, and are replaced in s as follows:

%a The abbreviated weekday name according to the current locale.
%A The full weekday name according to the current locale.
%b The abbreviated month name according to the current locale.
%B The full month name according to the current locale.
%c The preferred date and time representation for the current locale.
%C The century number (year/100) as a 2-digit integer. (SU)
%d The day of the month as a decimal number (range 01 to 31).
%D Equivalent to %m/%d/%y. (Yecch --- for Americans only. Americans should note that in other countries %d/%m/%y is rather common. This means that in international context this format is ambiguous and should not be used.) (SU)
%e Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space. (SU)
%E Modifier: use alternative format, see below. (SU)
%F Equivalent to %Y-%m-%d (the ISO 8601 date format). (C99)
%G The ISO 8601 year with century as a decimal number. The 4-digit year corresponding to the ISO week number (see %V). This has the same format and value as %y, except that if the ISO week number belongs to the previous or next year, that year is used instead. (TZ)
%g Like %G, but without century, i.e., with a 2-digit year (00-99). (TZ)
%h Equivalent to %b. (SU)
%H The hour as a decimal number using a 24-hour clock (range 00 to 23).
%I The hour as a decimal number using a 12-hour clock (range 01 to 12).
%j The day of the year as a decimal number (range 001 to 366).
%k The hour (24-hour clock) as a decimal number (range 0 to 23); single digits are preceded by a blank. (See also %H.) (TZ)
%l The hour (12-hour clock) as a decimal number (range 1 to 12); single digits are preceded by a blank. (See also %I.) (TZ)
%m The month as a decimal number (range 01 to 12).
%M The minute as a decimal number (range 00 to 59).
%n A newline character. (SU)
%O Modifier: use alternative format, see below. (SU)
%p Either 'AM' or 'PM' according to the given time value, or the corresponding strings for the current locale. Noon is treated as 'pm' and midnight as 'am'.
%P Like %p but in lowercase: 'am' or 'pm' or a corresponding string for the current locale. (GNU)
%r The time in a.m. or p.m. notation. In the POSIX locale this is equivalent to '%I:%M:%S %p'. (SU)
%R The time in 24-hour notation (%H:%M). (SU) For a version including the seconds, see %T below.
%s The number of seconds since the Epoch, i.e., since 1970-01-01 00:00:00 UTC. (TZ)
%S The second as a decimal number (range 00 to 60). (The range is up to 60 to allow for occasional leap seconds.)
%t A tab character. (SU)
%T The time in 24-hour notation (%H:%M:%S). (SU)
%u The day of the week as a decimal, range 1 to 7, Monday being 1. See also %w. (SU)
%U The week number of the current year as a decimal number, range 00 to 53, starting with the first Sunday as the first day of week 01. See also %V and %W.
%V The ISO 8601:1988 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week. See also %U and %W. (SU)
%w The day of the week as a decimal, range 0 to 6, Sunday being 0. See also %u.
%W The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01.
%x The preferred date representation for the current locale without the time.
%X The preferred time representation for the current locale without the date.
%y The year as a decimal number without a century (range 00 to 99).
%Y The year as a decimal number including the century.
%z The time-zone as hour offset from GMT. Required to emit RFC 822-conformant dates (using "%a, %d %b %Y %H:%M:%S %z"). (GNU)
%Z The time zone or name or abbreviation.
%% A literal '%' character.
Retrieved from "https://wiki.filezilla-project.org/wiki/index.php?title=Date_and_Time_formatting&oldid=4958"