DATENAME (Transact-SQL)

Sintaxe

DATENAME ( datepart , date )

Argumentos

• datepart
  É a parte da date a ser retornada. A tabela a seguir lista todos os argumentos datepart válidos. Equivalentes de variáveis definidas pelo usuário não são válidas.

  datepart	Abreviações
  year	yy, yyyy
  quarter	qq, q
  month	mm, m
  dayofyear	dy, y
  day	dd, d
  week	wk, ww
  weekday	dw
  hour	hh
  minute	mi, n
  second	ss, s
  millisecond	ms
  microsecond	mcs
  nanosecond	ns
  TZoffset	tz

• date
  É uma expressão que pode ser resolvida para um valor time, date, smalldatetime, datetime, datetime2 ou para um valor datetimeoffset. date pode ser uma expressão, uma expressão de coluna, uma variável definida pelo usuário ou uma cadeia de caracteres literal.

  Para evitar ambiguidade, use anos de quatro dígitos. Para obter informações sobre anos de dois dígitos, consulte Opção two digit year cutoff.

Tipo de retorno

nvarchar

Valor de retorno

• Cada datepart e suas abreviações retornam o mesmo valor.

O valor do retorno depende do ambiente de idioma definido usando SET LANGUAGE e do idioma padrão do logon. O valor do retorno depende de SET DATEFORMAT se date for uma literal de cadeia de caracteres de alguns formatos. SET DATEFORMAT não afeta o valor de retorno quando a data é uma expressão de coluna de um tipo de dados de data de hora.

Para versões do SQL Server posteriores à SQL Server 2000, quando o parâmetro date tem um argumento de tipo de dados date, o valor de retorno depende da definição especificada por meio de SET DATEFIRST.

SELECT DATENAME(year, '12:10:30.123')
    ,DATENAME(month, '12:10:30.123')
    ,DATENAME(day, '12:10:30.123')
    ,DATENAME(dayofyear, '12:10:30.123')
    ,DATENAME(weekday, '12:10:30.123');

SELECT DATENAME(hour, '2007-06-01')
    ,DATENAME(minute, '2007-06-01')
    ,DATENAME(second, '2007-06-01');

Comentários

DATENAME pode ser usado na lista de seleção, cláusulas WHERE, HAVING, GROUP BY e ORDER BY. No SQL Server 2008 R2, DATENAME converte implicitamente literais de cadeia como tipo datetime2. Isso significa que DATEDIFF não oferece mais suporte ao formato YDM quando a data é transmitida como cadeia de caracteres. É necessário converter explicitamente a cadeia de caracteres em um tipo datetime ou smalldatetime para usar o formato YDM.

Exemplos

O exemplo a seguir retorna as partes de data da data especificada.

SELECT DATENAME(datepart,'2007-10-30 12:15:32.1234567 +05:10')

Aqui está o conjunto de resultados.

Consulte também

Referência