Freigeben über

TIMEFROMPARTS (Transact-SQL)

  • Artikel

Gibt einen time-Wert für die angegebene Uhrzeit mit der angegebenen Genauigkeit zurück.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • hour
    Ganzzahliger Ausdruck, der die Stunden angibt.

  • minute
    Ganzzahliger Ausdruck, der die Minuten angibt.

  • seconds
    Ganzzahliger Ausdruck, der die Sekunden angibt.

  • fractions
    Ganzzahliger Ausdruck, der die Sekundenbruchteile angibt.

  • precision
    Ganzzahliges Literal, das die Genauigkeit des zurückzugebenden time-Werts angibt.

Rückgabetypen

time ( precision )

Hinweise

TIMEROMPARTS gibt einen vollständig initialisierten Uhrzeitwert zurück. Wenn die Argumente ungültig sind, wird ein Fehler ausgegeben. Wenn einer der Parameter einen NULL-Wert aufweist, wird NULL zurückgegeben. Wenn jedoch das precision-Argument NULL ist, wird ein Fehler ausgelöst.

Das fractions-Argument ist vom precision-Argument abhängig. Wenn beispielsweise precision den Wert 7 hat, dann stellt jeder Bruchteil 100 Nanosekunden dar. Ist precision jedoch 3, dann stellt jeder Bruchteil eine Millisekunde dar. Wenn der Wert von precision 0 (null) ist, dann muss auch der Wert von fractions 0 (null) sein; andernfalls wird ein Fehler ausgelöst.

Diese Funktion kann remote auf Servern mit SQL Server 2012 oder einer höheren Version ausgeführt werden. Sie kann nicht remote auf Servern mit einer Version vor SQL Server 2012 ausgeführt werden.

Beispiele

A.Einfaches Beispiel ohne Sekundenbruchteile

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

Dies ist das Resultset.

Result
--------------------
23:59:59.0000000

(1 row(s) affected)

B.Beispiel mit Sekundenbruchteilen

Das folgende Beispiel zeigt die Verwendung der Parameter fractions und precision:

  1. Wenn fractions über den Wert 5 und precision über den Wert 1 verfügt, dann stellt der Wert von fractions 5/10 einer Sekunde dar.

  2. Wenn fractions über den Wert 50 und precision über den Wert 2 verfügt, dann stellt der Wert von fractions 50/100 einer Sekunde dar.

  3. Wenn fractions über den Wert 500 und precision über den Wert 3 verfügt, dann stellt der Wert von fractions 500/1000 einer Sekunde dar.

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

Dies ist das Resultset.

----------------
14:23:44.5

(1 row(s) affected)


----------------
14:23:44.50

(1 row(s) affected)


----------------
14:23:44.500

(1 row(s) affected)