Sdílet prostřednictvím


DATUMČASČAS, posun z částí (Transact-SQL)

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)databáze SQL v Microsoft Fabric

Vrací hodnotu datetimeoffset pro specifikované argumenty data a času. Vrácená hodnota má přesnost určenou argumentem přesnosti a offset specifikovaný argumenty offsetu.

Transact-SQL konvence syntaxe

Syntaxe

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

Arguments

rok
Celočíselný výraz, který určuje rok.

měsíc
Celočíselný výraz, který určuje měsíc.

den
Celočíselný výraz, který určuje den.

hodina
Celočíselný výraz, který určuje hodiny.

minuta
Celočíselný výraz, který určuje minuty.

sekundy
Celočíselný výraz, který určuje sekundy.

zlomky
Celočíselný výraz, který určuje hodnotu zlomku sekund.

hour_offset
Celočíselný výraz, který určuje hodinovou část časového posunu.

minute_offset
Celočíselný výraz, který určuje minutovou část posunu časového pásma.

přesnost
Celočíselná literální hodnota, která určuje přesnost hodnoty datetimeoffset , která DATETIMEOFFSETFROMPARTS se vrátí.

Návratové typy

datetimeoffset(přesnost)

Poznámky

DATETIMEOFFSETFROMPARTS vrací plně inicializovaný datový typ datetimeoffset . Argumenty posunu představují posun časového pásma. Pro argumenty vynechaného posunu předpokládá časový posun – 00:00 tedy žádný posun časového pásmaDATETIMEOFFSETFROMPARTS. Pro specifikované argumenty posunu se DATETIMEOFFSETFROMPARTS očekává hodnota pro oba argumenty a obě hodnoty jsou kladné nebo záporné. Pokud má minute_offset hodnotu a hour_offset žádnou hodnotu, DATETIMEOFFSETFROMPARTS vznikne chyba. DATETIMEOFFSETFROMPARTS vyvolá chybu, pokud ostatní argumenty mají neplatné hodnoty. Pokud má alespoň jeden požadovaný argument hodnotuNULL, DATETIMEOFFSETFROMPARTS vrátí .NULL Pokud však má argument přesnosti hodnotu NULL , DATETIMEOFFSETFROMPARTS pak vyvolá chybu.

Argument zlomků závisí na argumentu přesnosti. Například pro hodnotu přesnosti 7 představuje každý zlomek 100 nanosekund; pro přesnost 3 každý zlomek představuje milisekundu. Pro hodnotu přesnosti nula musí být hodnota zlomků také nulová; jinak DATETIMEOFFSETFROMPARTS způsobí chybu.

Tato funkce je schopná vzdáleně připojit k serverům SQL Server 2012 (11.x) a vyšším. Není vzdáleně přidělován serverům, které mají verzi pod SQL Server 2012 (11.x).

Examples

A. Příklad bez zlomků sekundy

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

Tady je soubor výsledků.

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

B. Příklad s zlomky sekundy

Tento příklad ukazuje použití parametrů zlomků a přesnosti :

  1. Když má zlomek hodnotu 5 a přesnost hodnotu 1, hodnota zlomků představuje 5/10 sekundy.

  2. Když má zlomek hodnotu 50 a přesnost hodnotu 2, hodnota zlomků představuje 50/100 sekundy.

  3. Když má zlomek hodnotu 500 a přesnost hodnotu 3, pak hodnota zlomků představuje 500/1000 sekundy.

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  

Tady je soubor výsledků.

----------------------------------  
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)  

Viz také

datetimeoffset (Transact-SQL)
V ČASOVÉM PÁSMU (Transact-SQL)