DATETIMEOFFSETFROMPARTS (Transact-SQL)

Vonatkozik a következőkre:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalitikai Platform System (PDW)SQL adatbázis a Microsoft Fabric-ben

A megadott dátum és idő argumentumokhoz datetimeoffset értéket ad vissza. A visszaadott érték pontossága a precízitási argumentum által meghatározott, és az eltolás az eloszlás argumentumok által meghatározott eltéréssel.

Transact-SQL szintaxis konvenciók

Szemantika

DATETIMEOFFSETFROMPARTS ( year, month, day, hour, minute, seconds, fractions, hour_offset, minute_offset, precision )  

Arguments

év
Egy egész szám kifejezés, amely egy évet határoz meg.

hónap
Egy egész számú kifejezés, amely egy hónapot megad.

nap
Egy egész számkifejezés, amely egy napot megad.

óra
Egy egész szám kifejezés, amely meghatározza az órákat.

perc
Egy egész szám kifejezés, amely meghatározza a perceket.

repeta
Egy egész számú kifejezés, amely meghatározza a másodperceket.

Frakciók
Egy egész számkifejezés, amely egy törtmásodperces értéket határoz meg.

hour_offset
Egy egész számkifejezés, amely meghatározza az időzóna eltolódásának óraszámos részét.

minute_offset
Egy egész számú kifejezés, amely meghatározza az időzóna eloszlásának perces részét.

pontossági
Egy egész literális érték, amely meghatározza a vissza fog térni a datetime-offset érték DATETIMEOFFSETFROMPARTS pontosságát.

Visszatérési típusok

datetimeoffset (preciitás)

Megjegyzések

DATETIMEOFFSETFROMPARTS Teljesen inicializált datetimeoffset adattípust ad vissza. Az elmozdulási argumentumok az időzóna eltérést jelentik. A kihagyott eloszlat argumentumok esetén DATETIMEOFFSETFROMPARTS feltételezzük, hogy időzóna eltolódás 00:00 van – vagyis nincs időzóna eltolása. Meghatározott elmozdult argumentumok esetén DATETIMEOFFSETFROMPARTS mindkét érvet vár értéke, és mindkét érték pozitív vagy negatív. Ha minute_offset értéke van, hour_offset pedig nincs, DATETIMEOFFSETFROMPARTS hibát jelent. DATETIMEOFFSETFROMPARTS hibát jelent, ha a többi argumentum érvénytelen értékű. Ha legalább egy kötelező argumentumnak van NULL értéke, akkor DATETIMEOFFSETFROMPARTS visszaadja NULL-t . Azonban, ha a pontossági érvnek van NULL értéke, akkor DATETIMEOFFSETFROMPARTS hibát okoz.

A törtérv a pontossági érvtől függ. Például 7 pontosságú érték esetén minden tört 100 nanoszekundumust jelent; 3 pontossággal minden tört egy milliszekundot jelent. Nulla pontosságú érték esetén a törtértéknek is nullának kell lennie; különben DATETIMEOFFSETFROMPARTS hibát okoz.

Ez a funkció képes távolról csatlakoztatni SQL Server 2012 (11.x) szerverekre vagy annál magasabbra. Nem van távolról olyan szerverekhez, amelyek SQL Server 2012 (11.x) alatti verzióval rendelkeznek.

Példák

A. Egy példa másodperc töredéke nélkül

SELECT DATETIMEOFFSETFROMPARTS ( 2010, 12, 31, 14, 23, 23, 0, 12, 0, 7 ) AS Result;  

Itt van az eredmények összessége.

Result  
----------------------------------
2010-12-31 14:23:23.0000000 +12:00  
  
(1 row(s) affected)  

B. Példa egy másodperc törtével

Ez a példa bemutatja a tört - és pontossági paraméterek használatát:

1. Ha a törtek értéke 5, a precizitás pedig 1, akkor a törtérték 5/10 másodpercet képvisel.

2. Ha a törtek értéke 50, a pontosság pedig 2, akkor a törtek értéke 50/100 másodpercet képvisel.

3. Ha a törtek értéke 500, a precizitás pedig 3, akkor a törtérték 500/1000 másodpercet képvisel.

SELECT DATETIMEOFFSETFROMPARTS ( 2011, 8, 15, 14, 30, 00, 5, 12, 30, 1 );  
SELECT DATETIMEOFFSETFROMPARTS ( 2011, 8, 15, 14, 30, 00, 50, 12, 30, 2 );  
SELECT DATETIMEOFFSETFROMPARTS ( 2011, 8, 15, 14, 30, 00, 500, 12, 30, 3 );  
GO  

Itt van az eredmények összessége.

----------------------------------  
2011-08-15 14:30:00.5 +12:30  
  
(1 row(s) affected)  
  
----------------------------------  
2011-08-15 14:30:00.50 +12:30  
  
(1 row(s) affected)  
  
----------------------------------  
2011-08-15 14:30:00.500 +12:30  
  
(1 row(s) affected)  

Lásd még

datetimeoffset (Transact-SQL)
IDŐZÓNÁBAN (Transact-SQL)