Date and Datetime Formats in Tableau Next

Tableau Next recognizes and supports multiple date and datetime formats.

Required Editions

View supported editions.
User Permissions Needed
To change the data format in Tableau Next: Tableau Unmetered Platform Analyst or Tableau Next Platform Analyst permission set

A field with date or datetime data must be assigned a date and time format. This format is used when parsing the data and writing to the data lake object (DLO).

Tableau Next determines the applicable data type and format by reviewing a sample of the incoming raw data. You can override the data type for file-based connections (.csv and .xlsx files), but it is your responsibility to review your data and assign the appropriate data type and format. In the case of date and datetime data, if you choose to override the data type, make sure the format stays the same so that it still reflects the format in the raw data.

Overrides are only available for file-based connectors (.csv and .xlsx files).

Modify Date or Datetime Format

If you need to modify the format for a date or datetime field, you must do this before you save your data in a data lake object (DLO).

Required Editions

View supported editions.
User Permissions Needed
To modify date or datetime format: Tableau Unmetered Platform Analyst or Tableau Next Platform Analyst permission set
  1. After uploading your data, use the action menu for the table you want to modify and select Customize Data Lake Object.
  2. In the preview of the data, click the down arrow next to the column whose format you want to change.
  3. From the Data Types list, select Date or Date & Time.
    The current format is displayed.
  4. Click the down arrow to see other possible formats or to manually enter the format.
  5. Click Save to update the format.
  6. Click Save to open the Create Data Lake Object dialog.
  7. To save the DLO to a data space other than the default data space, click Edit and select the data space or data spaces in which you want to save the DLO, then click Assign Data Spaces.
    If you don't see any data spaces other than the default data space, none have been set up in Data Cloud or you do not have access to them.
  8. Click Create to create a DLO with your data and the updated date or datetime format.

Supported Date and Datetime Formats

Tableau Next supports multiple date and datetime data types.

A field with date or datetime data must be assigned a date and time format. This format is used when parsing the data and writing to the data lake object (DLO).

Tableau Next suggests the applicable data type and format by reviewing a sample of the incoming raw data. You can override the data type by customizing the object prior to its creation, but it is your responsibility to review your data and assign the appropriate data type and format. If you choose to override a date type to a datetime or a datetime to a date type, make sure the format stays the same so that it still reflects the format in the raw data.

Overrides are only available for file-based connectors (.csv and .xlsx files).

The table shows the date and time pattern strings and their definitions. Use this table when validating the date and time format suggested for each field. The patterns are case-sensitive and failure to differentiate between cases can produce vastly different results. For example, “MM” is used to represent the month while “mm” represents the minute.

LETTER Date or Time COMPONENT EXAMPLES
G Era designator AD
y Year 1996, 96
Y Week-based year

December 31, 2019

Output is 2020, as December 31 falls in the first week of 2020.

M Month in year July, Jul, 07
w Week in year 27
W Week in month 2
D Day in year 189
d Day in month 10
F Day of week in month 2
E Day name in week Tuesday, Tue
U Day number of week (1 equals Monday, 7 equals Sunday) 1
a AM or PM marker PM
H Hour in day (0-23) 0
k Hour in day (1-24) 24
K Hour in AM or PM (0-11) 0
h Hour in AM or PM (1-12) 12
m Minute in hour 30
s Second in minute 55
S Millisecond 978
z Time zone Pacific Standard Time, PST, GMT-08:00
Z Time zone -0800
X Time zone -08, -0800, -08:00

The table below shows date formats and time pattern strings and their definitions. These are patterns that can be recognized automatically by Tableau Next. Use this table when validating the date and time format suggested for each field. The patterns are case-sensitive and failure to differentiate between cases can produce vastly different results. For example, “MM” is used to represent the month while “mm” represents the minute. Make sure the datetime assigned is correct if data is ambiguous. For example, 06-02-2021 could be June 2 or February 6.

Supported Date and DateTime Formats
Date and Time Format Example
yyyy-MM-dd'T'HH:mm:ss 2021-06-22T10:47:36
yyyy-MM-dd'T'HH:mm:ssXX  
yyyy-MM-dd'T'HH:mm:ss.S 2021-06-22T10:47:36.3
yyyy-MM-dd'T'HH:mm:ss.SZ 2021-06-22T10:47:36.333-0300
yyyy-MM-dd'T'HH:mm:ss.SS 2021-06-22T10:47:36.33
yyyy-MM-dd'T'HH:mm:ss.SS zzz  
yyyy-MM-dd'T'HH:mm:ss.SS ZZZZZ  
yyyy-MM-dd'T'HH:mm:ss.SSS 2021-06-22T10:47:36.333
yyyy-MM-dd'T'HH:mm:ss.SSSS 2021-06-22T10:47:36.0333
yyyy-MM-dd'T'HH:mm:ss.SSSSS 2021-06-22T10:47:36.00333
yy/MM/dd 21/06/22
yyyy/MM/dd 2021/06/22
yyyy/MM/dd HH:mm:ss 2021/06/22 10:47:36
yyyy/MM/dd HH:mm:ss zzz  
yyyy/MM/dd HH:mm:ss ZZZZZ  
yyyy/MM/dd HH:mm:ss.SSS 2021/06/22 10:47:36.333
yyyy/MM/dd HH:mm:ss.SSS zzz  
yyyy/MM/dd HH:mm:ss.SSS ZZZZZ  
yy/MM/dd HH:mm:ss 21/06/22 10:47:36
yy/MM/dd HH:mm:ss zzz  
yy/MM/dd HH:mm:ss ZZZZZ  
yy/MM/dd HH:mm:ss.SSS 21/06/22 10:47:36.333
yy/MM/dd HH:mm:ss.SSS zzz  
yy/MM/dd HH:mm:ss.SSS ZZZZZ  
yyyy-MM-dd 2021-06-22
yyyy-MM-dd HH:mm 2021-06-22 10:47
yyyy-MM-dd HH:mm zzz  
yyyy-MM-dd HH:mm ZZZZZ 2021-06-22 10:47 -0300
yyyy-MM-dd HH:mm:ss 2021-06-22 10:47:36
yyyy-MM-dd HH:mm:ss zzz  
yyyy-MM-dd HH:mm:ss ZZZZZ  
yyyy-MM-dd HH:mm:ss.SSS 2021-06-22 10:47:36.333
yyyy-MM-dd HH:mm:ss.SSS zzz  
yyyy-MM-dd HH:mm:ss.SSS ZZZZZ  
yy-MM-dd 21-06-22
yy-MM-dd HH:mm:ss 21-06-22 10:47:36
yy-MM-dd HH:mm:ss zzz  
yy-MM-dd HH:mm:ss ZZZZZ  
yy-MM-dd HH:mm:ss.SSS 21-06-22 10:47:36.333
yy-MM-dd HH:mm:ss.SSS zzz  
yy-MM-dd HH:mm:ss.SSS ZZZZZ  
yy-MM-dd HH:mm zzz  
yy-MM-dd HH:mm ZZZZZ 21-06-22 10:47 -0300
MMM dd,yy Jun 22,21
MMM dd,yy HH:mm:ss Jun 22,21 10:47:36
MMM dd,yy HH:mm:ss zzz  
MMM dd,yy HH:mm:ss ZZZZZ  
MMM dd,yy HH:mm:ss.SSS Jun 22,21 10:47:36.333
MMM dd,yy HH:mm:ss.SSS zzz  
MMM dd,yy HH:mm:ss.SSS ZZZZZ  
MMM dd, yyyy Jun 22, 2021
MMM dd, yyyy hh:mm a Jun 22, 2021 10:47 AM
MMM dd, yyyy HH:mm:ss a Jun 22, 2021 10:47:36 AM
MMM dd, yyyy HH:mm:ss.SSS a Jun 22, 2021 10:47:36.333 AM
MMMMMM dd,yy June 22,21
MMMMMM dd,yy HH:mm:ss June 22,21 10:47:36
MMMMMM dd,yy HH:mm:ss.SSS June 22,21 10:47:36.333
MMMMM dd, yyyy June 22, 2021
MMMMMM dd, yyyy June 22, 2021
MMMMMM dd, yyyy HH:mm:ss June 22, 2021 10:47:36
MMMMMM dd, yyyy HH:mm:ss.SSS June 22, 2021 10:47:36.333
MM/dd/yy 06/22/21
MM/dd/yy HH:mm 06/22/21 10:47
MM/dd/yy HH:mm zzz  
MM/dd/yy HH:mm ZZZZZ  
MM/dd/yy HH:mm:ss 06/22/21 10:47:36
MM/dd/yy HH:mm:ss zzz  
MM/dd/yy HH:mm:ss ZZZZZ  
MM/dd/yy HH:mm:ss.SSS 06/22/21 10:47:36.333
MM/dd/yy HH:mm:ss.SSS zzz  
MM/dd/yy HH:mm:ss.SSS ZZZZZ  
MM/dd/yyyy 06/22/2021
MM/dd/yyyy HH:mm 06/22/2021 10:47
MM/dd/yyyy HH:mm zzz 06/22/2021 10:47 AST
MM/dd/yyyy HH:mm ZZZZZ 06/22/2021 10:47 -0300
MM/dd/yyyy HH:mm:ss 06/22/2021 10:47:36
MM/dd/yyyy HH:mm:ss zzz 06/22/2021 10:47:36 AST
MM/dd/yyyy HH:mm:ss ZZZZZ 06/22/2021 10:47:36 -0300
MM/dd/yyyy HH:mm:ss.SSS  
MM/dd/yyyy HH:mm:ss.SSS zzz  
MM/dd/yyyy HH:mm:ss.SSS ZZZZZ  
MM/dd/yyyy hh:mm a 06/22/2021 10:47 pm
MM/dd/yyyy hh:mm:ss a 06/22/2021 10:47:36 am
MM/dd/yyyy hh:mm:ss aa 06/22/2021 10:47:36 am
MM-dd-yy 06-22-21
MM-dd-yy HH:mm:ss 06-22-21 10:47:36
MM-dd-yy HH:mm:ss zzz  
MM-dd-yy HH:mm:ss ZZZZZ  
MM-dd-yy HH:mm:ss.SSS 06-22-21 10:47:36.333
MM-dd-yy HH:mm:ss.SSS zzz  
MM-dd-yy HH:mm:ss.SSS ZZZZZ  
MM-dd-yyyy 06-22-2021
MM-dd-yyyy HH:mm:ss 06-22-2021 10:47:36
MM-dd-yyyy HH:mm:ss zzz 06-22-2021 10:47:36 ADT
MM-dd-yyyy HH:mm:ss ZZZZZ 06-22-2021 10:47:36 -0300
MM-dd-yyyy HH:mm:ss.SSS 06-22-2021 10:47:36.333
MM-dd-yyyy HH:mm:ss.SSS zzz 06-22-2021 10:47:36.333 ADT
MM-dd-yyyy HH:mm:ss.SSS ZZZZZ 06-22-2021 10:47:36.333 -0300
dd/MM/yy 22/06/21
dd/MM/yy HH:mm 22/06/21 10:47
dd/MM/yy HH:mm zzz  
dd/MM/yy HH:mm ZZZZZ  
dd/MM/yy HH:mm:ss 22/06/21 10:47:36
dd/MM/yy HH:mm:ss zzz  
dd/MM/yy HH:mm:ss ZZZZZ  
dd/MM/yy HH:mm:ss.SSS 22/06/21 10:47:36.333
dd/MM/yy HH:mm:ss.SSS zzz  
dd/MM/yy HH:mm:ss.SSS ZZZZZ  
dd/MM/yyyy 22/06/2021
dd/MM/yyyy HH:mm 22/06/2021 10:47
dd/MM/yyyy HH:mm zzz 22/06/2021 10:47 AST
dd/MM/yyyy HH:mm ZZZZZ 22/06/2021 10:47 -0300
dd/MM/yyyy HH:mm:ss 22/06/2021 10:47:36
dd/MM/yyyy HH:mm:ss zzz 22/06/2021 10:47:36 AST
dd/MM/yyyy HH:mm:ss ZZZZZ 22/06/2021 10:47:36 -0300
dd/MM/yyyy HH:mm:ss.SSS 22/06/2021 10:47:36.333
dd/MM/yyyy HH:mm:ss.SSS zzz 22/06/2021 10:47:36.333 AST
dd/MM/yyyy HH:mm:ss.SSS ZZZZZ 22/06/2021 10:47:36.333 -0300
dd.MM.yyyy 22.06.2021
dd.MM.yyyy HH:mm 22.06.2021 10:47
dd.MM.yyyy HH:mm zzz  
dd.MM.yyyy HH:mm ZZZZZ  
dd.MM.yyyy HH:mm:ss 22.06.2021 10:47:36
dd.MM.yyyy HH:mm:ss zzz  
dd.MM.yyyy HH:mm:ss ZZZZZ  
dd.MM.yyyy HH:mm:ss.SSS 22.06.2021 10:47:36.333
dd.MM.yyyy HH:mm:ss.SSS zzz  
dd.MM.yyyy HH:mm:ss.SSS ZZZZZ  
dd.MM.yy 22.06.21
dd.MM.yy HH:mm 22.06.21 10:47
dd.MM.yy HH:mm zzz  
dd.MM.yy HH:mm ZZZZZ  
dd.MM.yy HH:mm:ss 22.06.21 10:47:36
dd.MM.yy HH:mm:ss zzz  
dd.MM.yy HH:mm:ss ZZZZ  
dd.MM.yy HH:mm:ss.SSS 22.06.21 10:47:36.333
dd.MM.yy HH:mm:ss.SSS zzz  
dd.MM.yy HH:mm:ss.SSS ZZZZZ  
dd-MM-yy 22-06-21
dd-MM-yy HH:mm:ss 22-06-21 10:47:36
dd-MM-yy HH:mm:ss zzz  
dd-MM-yy HH:mm:ss ZZZZZ  
dd-MM-yy HH:mm:ss.SSS 22-06-21 10:47:36.333
dd-MM-yy HH:mm:ss.SSS zzz  
dd-MM-yy HH:mm:ss.SSS ZZZZZ  
dd-MM-yyyy 22-06-2021
dd-MM-yyyy HH:mm:ss 22-06-2021 10:47:36
dd-MM-yyyy HH:mm:ss zzz 22-06-2021 10:47:36 AST
dd-MM-yyyy HH:mm:ss ZZZZZ 22-06-2021 10:47:36 -0300
dd-MM-yyyy HH:mm:ss.SSS 22-06-2021 10:47:36.333
dd-MM-yyyy HH:mm:ss.SSS zzz 22-06-2021 10:47:36.333 AST
dd-MM-yyyy HH:mm:ss.SSS ZZZZZ 22-06-2021 10:47:36.333 -0300
dd-MMM-yy 22-Jun-21
dd-MMM-yy HH:mm:ss 22-Jun-21 10:47:36
dd-MMM-yy HH:mm:ss zzz  
dd-MMM-yy HH:mm:ss ZZZZZ  
dd-MMM-yy HH:mm:ss.SSS 22-Jun-21 10:47:36.333
dd-MMM-yy HH:mm:ss.SSS zzz  
dd-MMM-yy HH:mm:ss.SSS ZZZZZ  
MMMdd/yy Jun22/21
yyyy-MM 2021-06
dd MMM yyyy  
EEE MMM dd HH:mm:ss zzz yyyy Tue Jun 22 10:47:36 GMT-03:00 2021