Função EXTRACT no Amazon QLDB - Amazon Quantum Ledger Database (Amazon QLDB)
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á.

Função EXTRACT no Amazon QLDB

Importante

Aviso de fim do suporte: os clientes existentes poderão usar o 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 PostgreSQL.

No Amazon QLDB, use a função EXTRACT para retornar o valor inteiro de uma parte de data ou hora especificada de um determinado timestamp.

Sintaxe

EXTRACT ( datetimepart FROM timestamp )

Argumentos

datetimepart

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

  • year

  • month

  • day

  • hour

  • minute

  • second

  • timezone_hour

  • timezone_minute

timestamp

O nome do campo ou a expressão do tipo de dados timestamp que a função extrai. Se esse parâmetro for de um tipo desconhecido (NULLouMISSING), a função retornará NULL.

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

EXTRACT(YEAR FROM `2010-01-01T`)                           -- 2010
EXTRACT(MONTH FROM `2010T`)                                -- 1 (equivalent to 2010-01-01T00:00:00.000Z)
EXTRACT(MONTH FROM `2010-10T`)                             -- 10
EXTRACT(HOUR FROM `2017-01-02T03:04:05+07:08`)             -- 3
EXTRACT(MINUTE FROM `2017-01-02T03:04:05+07:08`)           -- 4
EXTRACT(TIMEZONE_HOUR FROM `2017-01-02T03:04:05+07:08`)    -- 7
EXTRACT(TIMEZONE_MINUTE FROM `2017-01-02T03:04:05+07:08`)  -- 8

-- Runnable statements
SELECT EXTRACT(YEAR FROM `2010-01-01T`) FROM << 0 >> -- 2010
SELECT EXTRACT(MONTH FROM `2010T`) FROM << 0 >>      -- 1

Funções relacionadas