TIMECONVERT

This section contains reference documentation for the TIMECONVERT function.

Converts the value from a column that contains an epoch timestamp into another time unit. The converted value will be rounded down.

Signature

TIMECONVERT(col, fromUnit, toUnit)

The supported units are as follows:

  • DAYS

  • HOURS

  • MINUTES

  • SECONDS

  • MILLISECONDS

  • MICROSECONDS

  • NANOSECONDS

Usage Examples

These examples are based on the Batch JSON Quick Start.

select id, 
       created_at_timestamp, 
       cast(created_at_timestamp AS long) AS timeInMs,
       TIMECONVERT(created_at_timestamp, 'MILLISECONDS', 'DAYS') AS convertedTime
from githubEvents
LIMIT 1
idcreated_at_timestamptimeInMsconvertedTime

7044874109

2018-01-01 11:00:00.0

1514804400000

17532

select id, 
       created_at_timestamp, 
       cast(created_at_timestamp AS long) AS timeInMs,
       TIMECONVERT(created_at_timestamp, 'MILLISECONDS', 'HOURS') AS convertedTime
from githubEvents
LIMIT 1
idcreated_at_timestamptimeInMsconvertedTime

7044874109

2018-01-01 11:00:00.0

1514804400000

420779

select id, 
       created_at_timestamp, 
       cast(created_at_timestamp AS long) AS timeInMs,
       TIMECONVERT(created_at_timestamp, 'MILLISECONDS', 'SECONDS') AS convertedTime
from githubEvents
LIMIT 1
idcreated_at_timestamptimeInMsconvertedTime

7044874109

2018-01-01 11:00:00.0

1514804400000

1514804400

select id, 
       created_at_timestamp, 
       cast(created_at_timestamp AS long) AS timeInMs,
       TIMECONVERT(created_at_timestamp, 'MILLISECONDS', 'MILLISECONDS') AS convertedTime
from githubEvents
LIMIT 1
idcreated_at_timestamptimeInMsconvertedTime

7044874109

2018-01-01 11:00:00.0

1514804400000

1514804400000

select id, 
       created_at_timestamp, 
       cast(created_at_timestamp AS long) AS timeInMs,
       TIMECONVERT(created_at_timestamp, 'MILLISECONDS', 'MICROSECONDS') AS convertedTime
from githubEvents
LIMIT 1
idcreated_at_timestamptimeInMsconvertedTime

7044874109

2018-01-01 11:00:00.0

1514804400000

1514804400000000

select id, 
       created_at_timestamp, 
       cast(created_at_timestamp AS long) AS timeInMs,
       TIMECONVERT(created_at_timestamp, 'MILLISECONDS', 'NANOSECONDS') AS convertedTime
from githubEvents
LIMIT 1
idcreated_at_timestamptimeInMsconvertedTime

7044874109

2018-01-01 11:00:00.0

1514804400000

1514804400000000000