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 |