TIMEFROMPARTS (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

Egy idő értéket ad vissza a megadott időponthoz és a megadott pontossághoz.

Transact-SQL szintaxis konvenciói

Szintaxis

TIMEFROMPARTS ( hour, minute, seconds, fractions, precision )  

Érvek

óra
Órákat megadva egész szám.

perc
Perceket megadva egész szám.

másodperc
Másodpercet megadva egész szám.

törtek
Törteket megadva egész szám.

pontossági
Az idő pontosságát visszaadni kívánt érték pontosságát meghatározó egész szám.

Visszatérési típusok

idő (pontossági)

Megjegyzések

A TIMEFROMPARTS egy teljesen inicializált időértéket ad vissza. Ha az argumentumok érvénytelenek, a rendszer hibát jelez. Ha bármelyik paraméter null értékű, a függvény null értéket ad vissza. Ha azonban a pontossági argumentum null, akkor a függvény hibát jelez.

A törtek argumentum a pontossági argumentumtól függ. Ha például pontossági 7, akkor minden tört 100 nanoszekundumot jelöl; ha pontosság 3, akkor minden tört ezredmásodpercet jelöl. Ha pontossági értéke nulla, akkor a törtek értéke is nulla; ellenkező esetben hiba jelenik meg.

Ez a függvény az SQL Server 2012 -hez (11.x) és újabb verziókhoz távolról is elérhető. Nem távolíthető el az SQL Server 2012-nél (11.x) alacsonyabb verziójú kiszolgálóktól.

Példák

Egy. Egyszerű példa másodperc törtek nélkül

SELECT TIMEFROMPARTS ( 23, 59, 59, 0, 0 ) AS Result;  

Itt van az eredményhalmaz.

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

B. Példa másodperc törtrészekkel

Az alábbi példa a törtek és pontosságú paraméterek használatát mutatja be:

1. Ha törtek értéke 5, pontossági értéke 1, akkor a törtek értéke másodpercenként 5/10-et jelent.

2. Ha törtek értéke 50, pontossági értéke 2, akkor a törtek értéke 50/100 másodpercet jelent.

3. Ha törtek értéke 500, pontossági értéke 3, akkor a törtek értéke 500/1000 másodpercet jelent.

SELECT TIMEFROMPARTS ( 14, 23, 44, 5, 1 );  
SELECT TIMEFROMPARTS ( 14, 23, 44, 50, 2 );  
SELECT TIMEFROMPARTS ( 14, 23, 44, 500, 3 );  
GO  

Itt van az eredményhalmaz.

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