This documentation is related to an older version of Firebolt. For the most current documentation, see Firebolt documentation.

TO_WEEK (legacy)

You are looking at legacy documentation for Firebolt’s deprecated date and timestamp type functions. New types were introduced in DB version 3.19 under the names PGDATE and TIMESTAMPNTZ, and made generally available in DB version 3.22.

If you worked with Firebolt before DB version 3.22, you might still be using the legacy date and timestamp types. Determine which types you are using by executing the query SELECT EXTRACT(CENTURY FROM DATE '2023-03-16');. If this query returns an error, you are still using the legacy date and timestamp types and can continue with this documentation, or find instructions to use the new types here. If this query returns a result, you are already using the redesigned date and timestamp types and can use the EXTRACT function instead.

Converts a date or timestamp to a number representing the week. This function defines week 1 of a calendar year as the first full week of a calendar year starting on a Sunday.

Syntax

TO_WEEK(<date>)

Example

For Sunday, Jan. 1, 2017:

SELECT
    TO_WEEK(CAST('2017/01/01' AS DATE))

Returns: 1

For Monday, Jan. 1, 2018:

SELECT
    TO_WEEK(CAST('2018/01/01' AS DATE))

Returns: 0