DATE_ DIFF função na Amazon QLDB - Banco de dados Amazon Quantum Ledger (AmazonQLDB)
SintaxeArgumentosTipo de retornoExemplosFunções relacionadas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

DATE_ DIFF função na Amazon QLDB

Importante

Aviso de fim do suporte: os clientes existentes poderão usar a Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte Migrar um Amazon QLDB Ledger para o Amazon Aurora Postgre. SQL

Na AmazonQLDB, use a DATE_DIFF função para retornar a diferença entre as partes de data especificadas de dois carimbos de data/hora fornecidos.

Sintaxe

DATE_DIFF( datetimepart, timestamp1, timestamp2 )

Argumentos

datetimepart

A parte da data ou hora na qual a função opera. Esse parâmetro pode ser:

  • year

  • month

  • day

  • hour

  • minute

  • second

timestamp1, timestamp2

O nome do campo ou a expressão do tipo de dados timestamp que a função compara. If (Se) timestamp2 é posterior a timestamp1, o resultado é positivo. If (Se) timestamp2 é anterior ao timestamp1, o resultado é negativo.

Um valor literal de timestamp de Ion pode ser indicado com backticks (`...`). Para obter detalhes do formato e exemplos de valores de carimbo de data/hora, consulte Timestamps no documento de especificação do Amazon Ion.

Tipo de retorno

int

Exemplos

DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`)            -- 1
DATE_DIFF(year, `2010-12T`, `2011-01T`)                  -- 0 (must be at least 12 months apart to evaluate as a 1 year difference)
DATE_DIFF(month, `2010T`, `2010-05T`)                    -- 4 (2010T is equivalent to 2010-01-01T00:00:00.000Z)
DATE_DIFF(month, `2010T`, `2011T`)                       -- 12
DATE_DIFF(month, `2011T`, `2010T`)                       -- -12
DATE_DIFF(month, `2010-12-31T`, `2011-01-01T`)           -- 0 (must be at least a full month apart to evaluate as a 1 month difference)
DATE_DIFF(day, `2010-01-01T23:00Z`, `2010-01-02T01:00Z`) -- 0 (must be at least 24 hours apart to evaluate as a 1 day difference)

-- Runnable statements
SELECT DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`) FROM << 0 >> -- 1
SELECT DATE_DIFF(month, `2010T`, `2010-05T`) FROM << 0 >>         -- 4

Funções relacionadas