date (Transact-SQL)

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)SQL analytics endpoint in Microsoft FabricWarehouse in Microsoft Fabric

Definisce una data in SQL Server. Il tipo di dati date è stato introdotto in SQL Server 2008 (10.0.x).

Descrizione di date

Proprietà	valore
Sintassi	DATE
Utilizzo	DECLARE @MyDate DATE CREATE TABLE Table1 (Column1 DATE)
Formato predefinito dei valori letterali stringa (utilizzato per client legacy)	yyyy-MM-dd Per altre informazioni, vedere la sezione Compatibilità con le versioni precedenti per i client di livello inferiore.
Intervallo	0001-01-01 through 9999-12-31 (1582-10-15 attraverso 9999-12-31 per Informatica) Da 1 gennaio 1 d.C. a 31 dicembre 9999 d.C. (da 15 ottobre 1582 d.C. a 31 dicembre 9999 d.C. per Informatica)
Intervalli di elementi	yyyy è costituito da quattro cifre da 0001 a 9999 che rappresentano un anno. Informatica limita yyyy l'intervallo 1582 a 9999. MM è costituito da due cifre da 01 a 12 che rappresentano un mese nell'anno specificato. dd è costituito da due cifre da 01 a 31, a seconda del mese, che rappresenta un giorno del mese specificato.
Lunghezza in caratteri	10 posizioni
Precisione, scala	10, 0
Dimensioni dello spazio di archiviazione	3 byte, fissa
Struttura di archiviazione	un intero a 3 byte archivia la data
Accuratezza	Un giorno
Valore predefinito	1900-01-01 Questo valore viene usato per la parte relativa all'orario aggiunta per la conversione implicita da time a datetime2 o datetimeoffset.
Calendario	Gregoriano
Precisione in secondi frazionari definita dall'utente	No
Considerazione e conservazione delle differenze di fuso orario	No
Considerazione dell'ora legale	No

Formati di valore letterale stringa supportati per date

Nelle tabelle seguenti sono illustrati i formati di valore letterale stringa supportati per il tipo di dati date.

Numerico

Descrizione

mdy [m]m/dd/[yy]yy [m]m-dd-[yy]yy [m]m.dd.[yy]yy myd mm/[yy]yy/dd mm-[yy]yy/dd [m]m.[yy]yy.dd dmy dd/[m]m/[yy]yy dd-[m]m-[yy]yy dd.[m]m.[yy]yy dym dd/[yy]yy/[m]m dd-[yy]yy-[m]m dd.[yy]yy.[m]m ymd [yy]yy/[m]m/dd [yy]yy-[m]m-dd [yy]yy-[m]m-dd

[m]m, dde [yy]yy rappresentano mese, giorno e anno in una stringa con segni di barra (/), trattini () o punti (-.) come separatori. Sono supportati solo anni a quattro cifre o a due cifre. Utilizzare sempre anni a quattro cifre quando possibile. Per specificare un numero intero da 0001 a 9999 che rappresenta l'anno di cutoff per interpretare gli anni a due cifre come anni a quattro cifre, utilizzare l'opzione di configurazione del server two digit year cutoff . Nota: per Informatica, yyyy è limitato all'intervallo 1582 di 9999. Un anno a due cifre con valore minore o uguale alle ultime due cifre dell'anno di cambio data si trova nello stesso secolo dell'anno di cambio data. Un anno a due cifre con valore maggiore delle ultime due cifre dell'anno di cambio data si trova nel secolo precedente a quello dell'anno di cambio data. Ad esempio, se il cutoff dell'anno a due cifre è l'impostazione predefinita 2049, l'anno a due cifre viene interpretato come 2049 e l'anno 4950 a due cifre viene interpretato come 1950. L'impostazione corrente della lingua determina il formato di data predefinito. È possibile modificare il formato di data usando le istruzioni SET LANGUAGE e SET DATEFORMAT. Il ydm formato non è supportato per la data.

Espressione alfabetica	Descrizione
mon [dd][,] yyyy mon dd[,] [yy] mon yyyy [dd] [dd] mon[,] yyyy dd mon[,][yy]yy dd [yy]yy mon [dd] yyyy mon yyyy mon [dd] yyyy [dd] mon	mon rappresenta il nome completo del mese o l'abbreviazione del mese, in base alla lingua corrente. Le virgole sono facoltative e l'uso delle maiuscole è ignorato. Per evitare ambiguità, esprimere gli anni nel formato a quattro cifre. Se manca il giorno, viene inserito il primo giorno del mese.

ISO 8601	Descrizione
yyyy-MM-dd yyyyMMdd	Uguale allo standard SQL. Si tratta dell'unico formato definito come standard internazionale.

Senza separatori	Descrizione
[yy]yyMMdd yyyy[MMdd]	I dati relativi all'elemento date possono essere specificati con quattro, sei o otto cifre. Una stringa a sei cifre o a otto cifre viene sempre interpretata come ymd. Il mese e il giorno devono sempre essere rappresentati da due cifre. Una stringa a quattro cifre viene interpretata come l'anno.

ODBC	Descrizione
{ d 'yyyy-MM-dd' }	Specifico delle API ODBC

Formato W3C XML

Descrizione

yyyy-MM-ddTZD

Supportato per l'utilizzo di XML/SOAP. TZD è l'operatore di progettazione del fuso orario (Z o +hh:mm o -hh:mm): - hh:mm rappresenta la differenza di fuso orario. hh è di due cifre, compreso tra 0 e 14, che rappresentano il numero di ore nella differenza di fuso orario. - mm è di due cifre, compreso tra 0 e 59, che rappresentano il numero di minuti aggiuntivi nell'offset del fuso orario. - + (più) o - (meno) è il segno obbligatorio della differenza di fuso orario. Questo simbolo indica che, per ottenere l'ora locale, la differenza di fuso orario viene aggiunta o sottratta dall'ora UTC (Coordinated Universal Time). L'intervallo valido di differenza di fuso orario è compreso tra -14:00 e +14:00.

Conformità agli standard ANSI e ISO 8601

date è conforme alla definizione dello standard ANSI SQL per il calendario gregoriano:

NOTA 85 - I tipi di dati Datetime consentiranno l'archiviazione delle date nel formato gregoriano nell'intervallo di date da 0001-01-01 CE a 9999-12-31 CE.

Il formato letterale stringa predefinito, usato per i client di livello inferiore, è conforme al modulo standard SQL definito come yyyy-MM-dd. Questo formato corrisponde alla definizione ISO 8601 per DATE.

Nota

Per Informatica, l'intervallo è limitato a 1582-10-15 (15 ottobre 1582 CE) a 9999-12-31 (31 dicembre 9999 CE).

Compatibilità con le versioni precedenti dei client

Alcune versioni precedenti dei client non supportano i tipi di dati time, date, datetime2 e datetimeoffset. Nella tabella seguente viene illustrato il mapping del tipo tra un'istanza di livello principale di SQL Server e i client legacy.

Tipo di dati di SQL Server	Formato predefiniti dei valori letterali stringa passati al client legacy	ODBC delle versioni precedenti	OLEDB delle versioni precedenti	JDBC delle versioni precedenti	SQLCLIENT delle versioni precedenti
time	hh:mm:ss[.nnnnnnn]	SQL_WVARCHAR oppure SQL_VARCHAR	DBTYPE_WSTR oppure DBTYPE_STR	Java.sql.String	String oppure SqString
date	yyyy-MM-dd	SQL_WVARCHAR oppure SQL_VARCHAR	DBTYPE_WSTR oppure DBTYPE_STR	Java.sql.String	String oppure SqString
datetime2	yyyy-MM-dd HH:mm:ss[.nnnnnnn]	SQL_WVARCHAR oppure SQL_VARCHAR	DBTYPE_WSTR oppure DBTYPE_STR	Java.sql.String	String oppure SqString
datetimeoffset	yyyy-MM-dd HH:mm:ss[.nnnnnnn] [+ or -]hh:mm	SQL_WVARCHAR oppure SQL_VARCHAR	DBTYPE_WSTR oppure DBTYPE_STR	Java.sql.String	String oppure SqString

Convertire i dati di data e ora

Quando si esegue la conversione in tipi di dati data e ora, SQL Server rifiuta tutti i valori che non riconosce come date o ore. Per informazioni sull'uso delle CAST funzioni e CONVERT con i dati di data e ora, vedere CAST e CONVERT (Transact-SQL).

Convertire la data in altri tipi di data e ora

Questa sezione descrive il risultato della conversione di un tipo di dati date in altri tipi di dati relativi a data e ora.

Quando la conversione è in time(n), la conversione non riesce e viene generato il messaggio di errore 206:

Conflitto di tipo operando: la data non è compatibile con l'ora.

Se la conversione è in datetime, il componente date viene copiato. Il codice seguente mostra i risultati della conversione di un valore date in un valore datetime .

DECLARE @date DATE = '12-10-25';
DECLARE @datetime DATETIME = @date;

SELECT @date AS '@date',
    @datetime AS '@datetime';

Questo è il set di risultati.

@date      @datetime
---------- -----------------------
2025-12-10 2025-12-10 00:00:00.000

Quando la conversione è in smalldatetime, il valore di date si trova nell'intervallo di un valore smalldatetime, il componente date viene copiato e il componente time viene impostato su 00:00:00.000. Quando il valore di data non rientra nell'intervallo di un valore smalldatetime , viene generato il messaggio di errore 242 e il valore smalldatetime è impostato su NULL:

La conversione di un tipo di dati date in tipi di dati smalldatetime ha generato un valore non compreso nell'intervallo.

Il codice seguente mostra i risultati della conversione di un valore date in un valore smalldatetime .

DECLARE @date DATE = '1912-10-25';
DECLARE @smalldatetime SMALLDATETIME = @date;

SELECT @date AS '@date',
    @smalldatetime AS '@smalldatetime';

Questo è il set di risultati.

@date      @smalldatetime
---------- -------------------
1912-10-25 1912-10-25 00:00:00

Per la conversione in datetimeoffset(n), la data viene copiata e l'ora è impostata su 00:00.0000000 +00:00. Il codice seguente mostra i risultati della conversione di un valore di data in un valore datetimeoffset(3).

DECLARE @date DATE = '1912-10-25';
DECLARE @datetimeoffset DATETIMEOFFSET(3) = @date;

SELECT @date AS '@date',
    @datetimeoffset AS '@datetimeoffset';

Questo è il set di risultati.

@date      @datetimeoffset
---------- ------------------------------
1912-10-25 1912-10-25 00:00:00.000 +00:00

Quando la conversione è in datetime2(n),il componente date viene copiato e il componente time è impostato su 00:00.000000. Il codice seguente mostra i risultati della conversione di un valore di data in un valore datetime2(3).

DECLARE @date DATE = '1912-10-25'
DECLARE @datetime2 DATETIME2(3) = @date;

SELECT @date AS '@date',
    @datetime2 AS '@datetime2(3)';

Questo è il set di risultati.

@date      @datetime2(3)
---------- -----------------------
1912-10-25 1912-10-25 00:00:00.000

Convertire i valori letterali stringa in data

Le conversioni da valori letterali stringa a tipi di data e ora sono consentite se tutte le parti delle stringhe hanno formati validi. In caso contrario, viene generato un errore di runtime. Le conversioni implicite o le conversioni esplicite che non specificano uno stile, dai tipi di data e ora ai valori letterali stringa, sono nel formato predefinito della sessione corrente. Nella tabella seguente vengono illustrate le regole per la conversione di un valore letterale stringa nel tipo di dati date.

Valore letterale stringa di input	data
ODBC DATE	Viene eseguito il mapping dei valori letterali stringa ODBC al tipo di dati datetime. Tutte le operazioni di assegnazione dai valori letterali di ODBC DATETIME in tipi di dati date determinano una conversione implicita tra datetime e il tipo definito dalle regole di conversione.
ODBC TIME	Vedere la regola relativa a ODBC DATE.
ODBC DATETIME	Vedere la regola relativa a ODBC DATE.
Solo DATE	Semplice
solo TIME	Vengono forniti i valori predefiniti.
solo TIMEZONE	Vengono forniti i valori predefiniti.
DATE + TIME	Viene utilizzata la parte di DATE della stringa di input.
DATE + TIMEZONE	Non consentiti.
TIME + TIMEZONE	Vengono forniti i valori predefiniti.
DATE + TIME + TIMEZONE	Viene utilizzata la parte DATE di DATETIME locale.

Esempi

Nell'esempio seguente vengono confrontati i risultati dell'esecuzione del cast di una stringa ai tipi di dati relativi a data e ora.

SELECT
    CAST('2022-05-08 12:35:29.1234567 +12:15' AS TIME(7)) AS 'time',
    CAST('2022-05-08 12:35:29.1234567 +12:15' AS DATE) AS 'date',
    CAST('2022-05-08 12:35:29.123' AS SMALLDATETIME) AS 'smalldatetime',
    CAST('2022-05-08 12:35:29.123' AS DATETIME) AS 'datetime',
    CAST('2022-05-08 12:35:29.1234567 +12:15' AS DATETIME2(7)) AS 'datetime2',
    CAST('2022-05-08 12:35:29.1234567 +12:15' AS DATETIMEOFFSET(7)) AS 'datetimeoffset';

Questo è il set di risultati.

Tipo di dati	Output
time	12:35:29.1234567
date	2022-05-08
smalldatetime	2022-05-08 12:35:00
datetime	2022-05-08 12:35:29.123
datetime2	2022-05-08 12:35:29.1234567
datetimeoffset	2022-05-08 12:35:29.1234567 +12:15

Vedi anche

• CAST e CONVERT (Transact-SQL)