This example demonstrates the use of Luxon to format dates on the client-side, where data on the wire (i.e. the data received from the server and submitted to it) is ISO 8601. The dates are translated into human readable format in the browser, both for display in the table columns and in the Editor form field input.
In the table columns we use a DataTables' datetime renderer to
display the data in the desired format. This allows sorting to be done on the ISO 8601 data (i.e. it will be sorted correctly), while the end user will see only
the formatted date.
In Editor's datetime input we use
displayFormat to describe the format the end user should see, and wireFormat to tell it that the wire format (i.e. the actual value) is
in a different format (typically this will be ISO 8601).
| First name | Last name | Updated date | Registered date |
|---|
The Javascript shown below is used to initialise the table shown in this example:
var editor; // use a global for the submit and return data rendering in the examples
$(document).ready(function() {
editor = new $.fn.dataTable.Editor( {
ajax: '/api/dates',
table: '#example',
fields: [ {
label: 'First name:',
name: 'first_name'
}, {
label: 'Last name:',
name: 'last_name'
}, {
label: 'Updated date:',
name: 'updated_date',
type: 'datetime',
def: function () { return new Date(); },
displayFormat: 'M/d/yyyy',
wireFormat: 'yyyy-MM-dd',
fieldInfo: 'US style m/d/y format',
keyInput: false
}, {
label: 'Registered date:',
name: 'registered_date',
type: 'datetime',
def: function () { return new Date(); },
displayFormat: 'cccc d MMMM yyyy',
wireFormat: 'yyyy-MM-dd',
fieldInfo: 'Verbose date format'
}
]
} );
$('#example').DataTable( {
dom: 'Bfrtip',
ajax: '/api/dates',
columns: [
{ data: 'first_name' },
{ data: 'last_name' },
{ data: 'updated_date', render: DataTable.render.datetime( 'M/d/yyyy' ) },
{ data: 'registered_date', render: DataTable.render.datetime( 'cccc d MMMM yyyy' ) }
],
select: true,
buttons: [
{ extend: 'create', editor: editor },
{ extend: 'edit', editor: editor },
{ extend: 'remove', editor: editor }
]
} );
} );
In addition to the above code, the following Javascript library files are loaded for use in this example:
The HTML shown below is the raw HTML table element, before it has been enhanced by DataTables:
This example uses a little bit of additional CSS beyond what is loaded from the library files (below), in order to correctly display the table. The additional CSS used is shown below:
The following CSS library files are loaded for use in this example to provide the styling of the table:
This table loads data by Ajax. The latest data that has been loaded is shown below. This data will update automatically as any additional data is loaded.
The script used to perform the server-side processing for this table is shown below. Please note that this is just an example script using PHP. Server-side processing scripts can be written in any language, using the protocol described in the DataTables documentation.