Table of Contents
Video tutorial
How do DateTime columns work in wpDataTables?
DateTime columns handle values that contain both a date and a time, rendering them in the format specified on the wpDataTables settings page.
- Rendering rules: values are cast as date and time, then formatted per the plugin settings.
- Sorting rules: datetime-based sorting.
- Applicable filter types: datetime range.
Issues to note:
- When working with Excel files, it is best to set the format of DateTime columns as plain text, since the PHPSpreadsheet library that parses Excel files does not parse all Excel date formats correctly.
- When using MySQL, cast timestamp columns to datetime to avoid problems.
- Global search does not support datetime searching.
What does a DateTime column look like?
In the example, a football match table has a “Date & time” column showing entries like 22/10/2020 01:30 PM alongside team and stadium information.
Datetime Table
| wdt_ID | Date & time | Home team | Away team | Stadium |
|---|---|---|---|---|
| 1 | 22/10/2020 01:30 PM | Bournemouth | Tottenham | Dean Court |
| 2 | 22/10/2020 04:00 PM | Arsenal | Middlesbrough | Emirates Stadium |
| 3 | 22/10/2020 04:00 PM | Burnley | Everton | Turf Moor |
| 4 | 22/10/2020 04:00 PM | Hull City | Stoke City | KCOM Stadium |
| 5 | 22/10/2020 04:00 PM | Leicester City | Crystal Palace | King Power Stadium |
| 6 | 22/10/2020 04:00 PM | Swansea City | Watford | Liberty Stadium |
| 7 | 22/10/2020 04:00 PM | West Ham United | Sunderland | London Stadium |
| 8 | 22/10/2020 06:30 PM | Liverpool | West Bromwich Albion | Anfield |
| 9 | 22/10/2020 06:30 PM | Manchester City | Southampton | Etihad Stadium |
| 10 | 22/10/2020 07:30 PM | Chelsea | Manchester United | Stamford Bridge |
| Date & time | Home team | Away team | Stadium |
How do I set the datetime input format?

When you create tables from external data sources, set the “Date input format” in the column settings so datetime values render correctly. DateTime rendering may fail if the plugin cannot determine the storage format; manually configuring the “Date input format” to match your source may be necessary for CSV, JSON, XML, Google Sheets, or plain-text Excel inputs.
Where can I learn more?
- Creating editable tables and filling table data manually
- Creating non-editable tables from Excel files
- Creating non-editable tables from Google Spreadsheets
- String (text) columns
- Integer columns
- Float columns
- Date columns
- Time columns
- Image columns
- URL link columns
- E-mail link columns
- Currency/price columns
- Formula (calculated) columns
- Coloring and styling columns
- Hiding (dynamic) columns
- Column types overview