Given a date string, or anything that sort of looks like a date string, format
will convert it to a Carbon instance and allow you to format it with PHP's datetime format variables.
event_date: April 15 2016
{{ event_date | format('Y-m-d') }}
{{ Statamic::modify($event_date)->format('Y-m-d') }}
2016-04-15
Parameters
Day
Character | Description | Example |
---|---|---|
d |
Day of the month, 2 digits with leading zeros | 01 to 31 |
D |
A textual representation of a day, three letters | Mon to Sun |
j |
Day of the month without leading zeros | 1 to 31 |
l |
A full textual representation of the day of the week | Sunday to Saturday |
N |
ISO 8601 numeric representation of the day of the week | 1 (for Monday) to 7 (for Sunday) |
S |
English ordinal suffix for the day of the month, 2 characters | st , nd , rd or th . Works well with j |
w |
Numeric representation of the day of the week | 0 (for Sunday) to 6 (for Saturday) |
z |
The day of the year (starting from 0) | 0 to 365 |
Week
Character | Description | Example |
---|---|---|
W |
ISO 8601 week number of year, weeks starting on Monday | 42 (the 42nd week in the year) |
Month
Value | Description | Example |
---|---|---|
F |
A full textual representation of a month, such as January or March | January to December |
m |
Numeric representation of a month, with leading zeros | 01 to 12 |
M |
A short textual representation of a month, three letters | Jan to Dec |
n |
Numeric representation of a month, without leading zeros | 1 to 12 |
t |
Number of days in the given month | 28 to 31 |
Year
Value | Description | Example |
---|---|---|
L |
Whether it's a leap year | 1 if it is a leap year, 0 otherwise. |
o |
ISO 8601 week-numbering year. | 1999 or 2003 |
Y |
A full numeric representation of a year, at least 4 digits, with - for years BCE. |
-0055 , 0787 , 1999 , 2003 |
y |
A two digit representation of a year | 99 or 03 |
Time
Value | Description | Example |
---|---|---|
a |
Lowercase Ante meridiem and Post meridiem | am or pm |
A |
Uppercase Ante meridiem and Post meridiem | AM or PM |
B |
Swatch Internet time (it's coming back, just you wait) | 000 to 999 |
g |
12-hour format of an hour without leading zeros | 1 to 12 |
G |
24-hour format of an hour without leading zeros | 0 to 23 |
h |
12-hour format of an hour with leading zeros | 01 to 12 |
H |
24-hour format of an hour with leading zeros | 00 to 23 |
i |
Minutes with leading zeros | 00 to 59 |
s |
Seconds with leading zeros | 00 to 59 |
u |
Microseconds. | 654321 |
v |
Milliseconds. Same note applies as for u . |
654 |
Timezone
Value | Description | Example |
---|---|---|
e |
Timezone identifier | UTC , GMT , Atlantic/Azores |
I |
Whether or not the date is in daylight saving time | 1 if Daylight Saving Time, 0 otherwise. |
O |
Difference to Greenwich time (GMT) without colon between hours and minutes | +0200 |
P |
Difference to Greenwich time (GMT) with colon between hours and minutes | +02:00 |
p |
The same as P , but returns Z instead of +00:00 (available as of PHP 8.0.0) |
+02:00 |
T |
Timezone abbreviation, if known; otherwise the GMT offset. | EST , MDT , +05 |
Z |
Timezone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive. | -43200 to 50400 |
Full Date/Time
Value | Description | Example |
---|---|---|
c |
ISO 8601 date | 2004-02-12T15:19:21+00:00 |
r |
RFC 2822 or RFC 5322 formatted date | Thu, 21 Dec 2000 16:01:07 +0200 |