Função TIMESTAMPTZ_CMP

TIMESTAMPTZ_CMP compara o valor de dois timestamps com valores de fuso horário e retorna um número inteiro. Se os carimbos de data/hora forem idênticos, a função retornará 0. Se o primeiro carimbo de data/hora for maior cronologicamente, a função retornará 1. Se o segundo carimbo de data/hora for maior, a função retornará –1.

Sintaxe

TIMESTAMPTZ_CMP(timestamptz1, timestamptz2)

Argumentos

timestamptz1

Uma coluna de tipo de dados TIMESTAMPTZ ou uma expressão que é avaliada implicitamente como um tipo TIMESTAMPTZ.

timestamptz2

Uma coluna de tipo de dados TIMESTAMPTZ ou uma expressão que é avaliada implicitamente como um tipo TIMESTAMPTZ.

Tipo de retorno

INTEGER

Exemplos

O exemplo a seguir compara os carimbos de data/hora com fusos horários e mostra os resultados da comparação.

SELECT TIMESTAMPTZ_CMP('2008-01-24 06:43:29+00', '2008-01-24 06:43:29+00'), TIMESTAMPTZ_CMP('2008-01-24 06:43:29+00', '2008-02-18 02:36:48+00'), TIMESTAMPTZ_CMP('2008-02-18 02:36:48+00', '2008-01-24 06:43:29+00');

timestamptz_cmp  | timestamptz_cmp | timestamptz_cmp
-----------------+-----------------+----------------
        0        |       -1        |       1