7.4. Datetime Directives
Similar in almost all programming language
Some minor differences like in JavaScript minutes are
i
, notM
Source: [1]
Usage |
Result |
Description |
---|---|---|
|
|
Year with century as a decimal number |
|
|
Month as a zero-padded decimal number |
|
|
Day of the month as a zero-padded decimal number |
|
|
Hour (24-hour clock) as a zero-padded decimal number |
|
|
Minute as a zero-padded decimal number |
|
|
Second as a zero-padded decimal number |
|
|
Microsecond as a decimal number, zero-padded on the left |
|
|
Time zone name (empty string if the object is naive) |
|
|
UTC offset in the form +HHMM or -HHMM (empty string if the object is naive) |
|
|
Weekday as locale's full name |
|
|
Weekday as locale's abbreviated name |
|
|
Month as locale's full name |
|
|
Month as locale's abbreviated name |
|
|
Hour (12-hour clock) as a zero-padded decimal number |
|
|
Locale's equivalent of either AM or PM |
7.4.1. Frequently Used
%Y
- Year with century as a decimal number%m
- Month as a zero-padded decimal number%d
- Day of the month as a zero-padded decimal number%H
- Hour (24-hour clock) as a zero-padded decimal number%M
- Minute as a zero-padded decimal number%S
- Second as a zero-padded decimal number%f
- Microsecond as a decimal number, zero-padded on the left%Z
- Time zone name (empty string if the object is naive)%z
- UTC offset in the form +HHMM or -HHMM (empty string if the object is naive)%A
- Weekday as locale's full name%a
- Weekday as locale's abbreviated name%B
- Month as locale's full name%b
- Month as locale's abbreviated name%I
- Hour (12-hour clock) as a zero-padded decimal number%p
- Locale's equivalent of either AM or PM
Examples:
%Y-%m-%d # 1969-07-21
%H:%M:%S # 02:56:15
%Y-%m-%d %H:%M:%S.%f %Z # 1969-07-21 02:56:15.123456 UTC
%A, %B %d, %Y at %I:%M %p # Monday, July 21, 1969 at 02:56 AM
7.4.2. Year
%Y
- Year with century as a decimal number%y
- Year without century as a zero-padded decimal number%G
- ISO 8601 year with century representing the year that contains the greater part of the ISO week (%V
)
%Y
- Year with century as a decimal number
0001
0002
2024
2025
9998
9999
%y
examples:
00
01
24
25
98
99
%G
examples:
0001
0002
2024
2025
9998
9999
7.4.3. Month
%m
- Month as a zero-padded decimal number%B
- Month as locale's full name%b
- Month as locale's abbreviated name
%m
- Month as a zero-padded decimal number:
01
02
11
12
%B
- Month as locale's full name:
January
February
November
December
%b
- Month as locale's abbreviated name:
Jan
Feb
Nov
Dec
7.4.4. Day
%d
- Day of the month as a zero-padded decimal number%a
- Weekday as locale's abbreviated name%A
- Weekday as locale's full name%u
- ISO 8601 weekday as a decimal number where 1 is Monday%w
- Weekday as a decimal number, where 0 is Sunday and 6 is Saturday%j
- Day of the year as a zero-padded decimal number
%d
- Day of the month as a zero-padded decimal number:
01
02
30
31
%a
- Weekday as locale's abbreviated name:
Mon
Tue
Wed
Thu
Fri
Sat
Sun
%A
- Weekday as locale's full name:
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
%u
- ISO 8601 weekday as a decimal number where 1 is Monday:
1
2
3
4
5
6
7
%w
- Weekday as a decimal number, where 0 is Sunday and 6 is Saturday:
0
1
2
3
4
5
6
%j
- Day of the year as a zero-padded decimal number:
001
002
364
365
7.4.5. Hour
%H
- Hour (24-hour clock) as a zero-padded decimal number%I
- Hour (12-hour clock) as a zero-padded decimal number%p
- Locale's equivalent of either AM or PM
%H
- Hour (24-hour clock) as a zero-padded decimal number:
00
01
23
%I
- Hour (12-hour clock) as a zero-padded decimal number:
01
02
12
%p
- Locale's equivalent of either AM or PM:
AM
PM
7.4.6. Minute
%M
- Minute as a zero-padded decimal number
%M
- Minute as a zero-padded decimal number:
00
01
59
7.4.7. Seconds
%S
- Second as a zero-padded decimal number
%S
- Second as a zero-padded decimal number:
00
01
59
7.4.8. Micro Seconds
%f
- Microsecond as a decimal number, zero-padded on the left
%f
- Microsecond as a decimal number, zero-padded on the left:
000000
000001
999999
7.4.9. Timezone
%Z
- Time zone name (empty string if the object is naive)%z
- UTC offset in the form +HHMM or -HHMM (empty string if the object is naive)%:z
- UTC offset in the form ±HH:MM[:SS[.ffffff]] (empty string if the object is naive).
%Z
- Time zone name (empty string if the object is naive):
UTC
EST
CST
%z
- UTC offset in the form +HHMM or -HHMM (empty string if the object is naive):
+0000
-0400
+1030
%:z
- UTC offset in the form ±HH:MM[:SS[.ffffff]] (empty string if the object is naive):
+00:00
-04:00
+10:30
7.4.10. Week
%U
- Week number of the year (Sunday as the first day of the week) as a zero padded decimal number. All days in a new year preceding the first Sunday are considered to be in week 0%W
- Week number of the year (Monday as the first day of the week) as a decimal number. All days in a new year preceding the first Monday are considered to be in week 0%V
- ISO 8601 week as a decimal number with Monday as the first day of the week. Week 01 is the week containing Jan 4
%U
- Week number of the year (Sunday as the first day of the week) as a zero padded decimal number. All days in a new year preceding the first Sunday are considered to be in week 0:
00
01
52
53
%W
- Week number of the year (Monday as the first day of the week) as a decimal number. All days in a new year preceding the first Monday are considered to be in week 0:
00
01
52
53
%V
- ISO 8601 week as a decimal number with Monday as the first day of the week. Week 01 is the week containing Jan 4:
01
02
52
53
7.4.11. Presets
%c
- Locale's appropriate date and time representation%x
- Locale's appropriate date representation%X
- Locale's appropriate time representation
%c
- Locale's appropriate date and time representation:
Tue Aug 16 21:30:00 1988 (en_US)
Di 16 Aug 21:30:00 1988 (de_DE)
%x
- Locale's appropriate date representation:
08/16/1988 (en_US)
16.08.1988 (de_DE)
%X
- Locale's appropriate time representation:
21:30:00
7.4.12. Other
%%
- A literal%
character
%%
- A literal %
character:
%