Using date parameters

Several WunderAutomation parameter returns a date. You can change how the date is returned in two ways. Using the format modifier to define how the date is represented in text, and the add parameter to change the actual date returned.

As with all parameters the easiest way to write the parameter placeholder is to use the parameter editor:

img

Date format

The date format is determined as follows:

  • If the parameter placeholder has a format modifier, it will be used.
  • If not, the default date format in WunderAutomation settings will be used
  • If no default date format is set, the WordPress default date format from Settings >> General Settings will be used

The format is defined using a standard PHP date formatting string. The format follow the PHP date() function. For example the sting Y-m-d would produce a date formated like this: 2020-05-12

Some common date and time formats:

Format string Description Example
l jS Simple text representation without month Monday 12th
F j, Y WordPress default date May 12, 2020
g:i a WordPress default time 4:59 pm
F j, Y g:i a Date and time combined (WordPress default) May 12, 2020 4:59 pm
Y-m-d H:i:s Date and time using ISO 8601 2020-05-20 16:59

See the date format reference section below for details on what each letter in the date string represents.

Some common date formatting tricks

Assuming the parameter would have returned May 12, 2020. The following special formatting strings would return:

Format string Description Result
F 1, Y First day of the month May 1 2020
F t, Y Last day of the month May 31, 2020

Adding or subtracting time

Using the add modifier, it’s possible to manipulate the returned date by adding or subtracting from it. This follows the syntax of the PHP strtotime() function. Some examples assuming that the original date returned from the parameter is 10:00 AM May 12th 2020.

Modifier Description Return
+1 day Adds one day. Note that both "day" and "days" work May 13, 2020
1 day Adds one day (the default is to add) May 13, 2020
-2 weeks Subtract 2 weeks. Note that both "week" and "weeks" works. April 28, 2020
-12 hours Subtract 12 hours. Note that both "hour" and "hours" work. May 11, 2020
last tuesday Calculates last Tuesday based on today being May 12, 2020 (also a Tuesday) May 5, 2020
next tuesday Calculates next Tuesday based on today being May 12, 2020 (also a Tuesday) May 19, 2020

Date format reference

Letter / code Description Example
d Day of month. Always 2 digits with leading zeros if needed 01 to 31
D A three letter text representation of the weekday Mon, Tue, Sun
j Day of the month, without leading zeros 1, 5, 31
l (lowercase ‘L’) Full text representation of the weeday Monday, Sunday
N ISO-8601 numeric representation of the weekday. 1 (Monday) to 7 (Sunday)
S English ordinal suffix for the day of the month, 2 characters st, nd, rd or th
w Numeric representation of weekday 0 (Sunday) to 6 (Saturday)
z The day of the year. Jan 1st is zero 0 to 365
W ISO-8601 week number of year, weeks starting on Monday 1, 10 52
F A full textual representation of a month, such as January or March January, March
m Numeric representation of a month, with leading zeros 01 (January), 11 (November)
M A short textual representation of a month, three letters Jan, Feb, Dec
n Numeric representation of a month, without leading zeros 1 to 12
t Number of days in the given month 28 to 31
L Leap year or not. 1 for a leap year, 0 for non leap year
o ISO-8601 week-numbering year. This has the same value as Y, except that if the ISO week number (W) belongs to the previous or next year, that year is used instead. (added in PHP 5.1.0) 1999 or 2020
Y A full numeric representation of a year, 4 digits 2018
y A two digit representation of the year 09
a Lowercase Ante meridiem and Post meridiem am or pm
A Uppercase Ante meridiem and Post meridiem AM or PM
B Swatch Internet time 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 01 to 23
i Minutes with leading zeros 0 to 59
s Seconds with leading zeros 0 to 59
e Timezone identifier UTC, GMT, Atlantic/Azores
I (capital i) Whether or not the date is in daylight saving time 1 for DST, 0 for standard time
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
T Timezone abbreviation EST
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