Description
This is an add-on for Advanced Custom Fields and Advanced Custom Fields Pro, which allows to create a Date and Time Picker field.
Features
- Create a date and time picker field
- Create a time picker field (without a date)
- Two time picker types: slider (only in ACF 5 – looks better) and dropdown list (takes less space)
- Define date and time format for each field
Compatibility
This ACF field type is compatible with ACF 5 (Pro) and ACF 4.
Credits
The plugin uses Timepicker Addon for jQuery UI Datepicker by Trent Richardson, licensed under the MIT license.
Icon made by SimpleIcon from Flaticon is licensed by CC 3.0 BY.
Installation
- Copy the
acf-date-time-picker
folder into yourwp-content/plugins
folder - Activate the Date & Time Picker for Advanced Custom Fields plugin via the plugins admin page
- Create a new field via ACF and select the Date & Time Picker type
- Please refer to the description for more info regarding the field type settings
FAQ
- How do I format the time?
-
You can format the time by creating a mask using the following characters:
H Hour with no leading 0 (24 hour) HH Hour with leading 0 (24 hour) h Hour with no leading 0 (12 hour) hh Hour with leading 0 (12 hour) m Minute with no leading 0 mm Minute with leading 0 s Second with no leading 0 ss Second with leading 0 t a or p for AM/PM T A or P for AM/PM tt am or pm for AM/PM TT AM or PM for AM/PM
The default time format is
HH:mm
.You can read more about formatting the time here.
- How do I format the date?
-
You can format the date by creating a mask using the following characters:
d day of month (no leading zero) dd day of month (two digit) o day of the year (no leading zeros) oo day of the year (three digit) D day name short DD day name long m month of year (no leading zero) mm month of year (two digit) M month name short MM month name long y year (two digit) yy year (four digit)
The default date format is
yy-mm-dd
.You can read more about formatting the date here.
- How do I format the date and time to display it on the frontend?
-
The plugin saves the date and time in the following format:
YYYY-MM-DD hh:mm:ss
(for example2016-04-01 16:57:00
). This is the format used by WordPress inwp_posts
table, so it’s easy to use this field value in custom meta queries. However the Advanced Custom Fields API returns the date and time in the format set in the field settings, so you can just usethe_field()
orget_field()
function in your theme.To display the date and time in a different format, you can use strtotime() and date() functions, for example:
echo date('d/m/Y g:i a', strtotime(get_field('date_and_time_field')));
You can also use format_value filter to format the field value.
Contributors & Developers
“Date & Time Picker for Advanced Custom Fields” is open source software. The following people have contributed to this plugin.
Contributors“Date & Time Picker for Advanced Custom Fields” has been translated into 1 locale. Thank you to the translators for their contributions.
Translate “Date & Time Picker for Advanced Custom Fields” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.4 (2016-05-03)
- German translation (props Moritz Lipp).
1.1.3 (2016-04-30)
- [Fixed] Do not try to convert empty string to date.
1.1.2 (2016-04-27)
- [Fixed] Transparent background of datepicker.
- [Fixed] Do not set the current time as a default value.
- Temporary removed the slider timepicker for ACF 4.
1.1.1 (2016-04-10)
- Updated .pot file.
- Polish translation.
1.1.0 (2016-04-06)
- Option for disabling past dates in datepicker.
1.0.0 (2016-04-02)
- Initial release.