DATETIME2FROMPARTS (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform Systeem (PDW)SQL-database in Microsoft Fabric

Deze functie geeft een datetime2-waarde terug voor de opgegeven datum- en tijdargumenten. De teruggegeven waarde heeft een precisie die door het precisieargument wordt gespecificeerd.

Transact-SQL syntaxis-conventies

Syntaxis

DATETIME2FROMPARTS ( year, month, day, hour, minute, seconds, fractions, precision )  

Arguments

jaar
Een gehele uitdrukking die een jaar specificeert.

maand
Een gehele uitdrukking die een maand specificeert.

dag
Een gehele uitdrukking die een dag specificeert.

uur
Een geheel getal dat de uren specificeert.

minuut
Een gehele expressie die de minuten specificeert.

Seconden
Een gehele uitdrukking die de seconden specificeert.

Breuken
Een gehele getaluitdrukking die een waarde van fractieseconden specificeert.

precisie
Een gehele expressie die de precisie specificeert van de datetime2-waarde die DATETIME2FROMPARTS zal terugkeren.

Retourtypen

Datetime2(precisie)

Opmerkingen

DATETIME2FROMPARTS geeft een volledig geïnitialiseerde datetime2-waarde terug. DATETIME2FROMPARTS zal een fout veroorzaken als ten minste één vereiste argument een ongeldige waarde heeft. DATETIME2FROMPARTS geeft null terug als ten minste één vereist argument een nulwaarde heeft. Als het precisieargument echter een nulwaarde heeft, DATETIME2FROMPARTS zal er een fout ontstaan.

Het breukenargument hangt af van het precisieargument . Bijvoorbeeld, voor een precisiewaarde van 7 vertegenwoordigt elke fractie 100 nanoseconden; voor een precisie van 3 vertegenwoordigt elke breuk een milliseconde. Voor een precisiewaarde van nul moet de waarde van breuken ook nul zijn; anders zal er DATETIME2FROMPARTS een fout ontstaan.

Deze functie kan op afstand worden overgebracht naar SQL Server 2012 (11.x) servers en hoger. Het wordt niet op afstand gelinkt naar servers die een versie onder SQL Server 2012 (11.x) hebben.

Voorbeelden

Eén. Een voorbeeld zonder fracties van een seconde

SELECT DATETIME2FROMPARTS ( 2010, 12, 31, 23, 59, 59, 0, 0 ) AS Result;  

Hier is het resultatenoverzicht.

Result  
---------------------------  
2010-12-31 23:59:59.0000000  
  
(1 row(s) affected)  

B. Voorbeeld met breuken van een seconde

Dit voorbeeld toont het gebruik van de breuk- en precisieparameters :

1. Wanneer breuken een waarde van 5 hebben en precisie een waarde van 1, vertegenwoordigt de waarde van breuken 5/10 van een seconde.

2. Wanneer breuken een waarde van 50 hebben en precisie een waarde van 2, vertegenwoordigt de waarde van breuken 50/100 van een seconde.

3. Wanneer breuken een waarde van 500 hebben en precisie een waarde van 3, dan vertegenwoordigt de waarde van breuken 500/1000 van een seconde.

SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 5, 1 );  
SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 50, 2 );  
SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 500, 3 );  
GO  

Hier is het resultatenoverzicht.

----------------------  
2011-08-15 14:23:44.5  
  
(1 row(s) affected)  
  
----------------------  
2011-08-15 14:23:44.50  
  
(1 row(s) affected)  
  
----------------------  
2011-08-15 14:23:44.500  
  
(1 row(s) affected)  

Zie ook

Datetime2 (Transact-SQL)