Ir para o conteúdo

Função de Banco de Dados mvSQL - DATENAME()

Resumo

Retorna uma parte de um valor de data ou data/hora com uma representação de string em inglês para dias e meses.

Sintaxe

DATENAME(<datepart>, <datetime>)

Parâmetros

Parte da Data

Parte da data Aliases Suporte ao fornecedor
year yy, yyyy Todos os fornecedores de RDBMS.
quarter qq, q SQL Server e SQLite
month mm, m Todos os fornecedores de RDBMS.
dayofyear dy, y SQL Server e SQLite
day dd, d Todos os fornecedores de RDBMS.
week wk, ww SQL Server e SQLite
weekday dw, w SQL Server e SQLite
hour hh Todos os fornecedores de RDBMS.
minute mi, n Todos os fornecedores de RDBMS.
second ss, s Todos os fornecedores de RDBMS.

A parte da data não deve ser citada.

A parte da data não diferencia maiúsculas de minúsculas.

O SQL Server calcula as semanas usando o domingo como início da semana. SQLite, por outro lado, usa segunda-feira.

Data Hora

Coluna ou expressão do tipo datetime ou date. Algumas partes de data esperam um datetime.

Devoluções

Retorna uma string que representa o nome da parte da data fornecida.

Independentemente de estar retornando um nome "segunda-feira" ou um valor que possa ser representado numericamente (2015), esse valor será uma string.

Observações

Para o Vinyl versão 3.3.33893 e superior, todos os fornecedores de banco de dados agora usarão a ISO 8601 (semanas começando na segunda-feira, começando em 1 na primeira segunda-feira do ano) para esta função.

As versões anteriores do Vinyl lidavam com os limites de data de maneira diferente. Por exemplo, o SQL Server calcula semanas usando o domingo como início da semana. SQLite, por outro lado, usa segunda-feira.

Exemplos

Expressão Devoluções
DATENAME(minute, TIMESTAMP('1997-01-02 12:13:14')) 13
DATENAME(hour, TIMESTAMP('1997-01-02 12:13:14')) 12
DATENAME(day, TIMESTAMP('1997-01-02 12:13:14')) 2
DATENAME(month, TIMESTAMP('1997-01-02 12:13:14')) January
DATENAME(month, TIMESTAMP('1997-12-02 12:13:14')) December
DATENAME(weekday, TIMESTAMP('1997-01-02 12:13:14')) Thursday
DATENAME(year, TIMESTAMP('1997-01-02 12:13:14')) 1997