Sdílet prostřednictvím


_get_tzname

Získá řetězcové vyjádření znaků název časového pásma nebo název zóny (běžný čas) letního času (DST).

errno_t _get_tzname(
    size_t* pReturnValue,
    char* timeZoneName,
    size_t sizeInBytes,
    int index    
);

Parametry

  • [out] pReturnValue
    Délka řetězce timeZoneName včetně ukončovací znak NULL.

  • [out] timeZoneName
    Adresu řetězec znaků pro vyjádření název časového pásma nebo název zóny (běžný čas) letního času (DST) v závislosti na index.

  • [in] sizeInBytes
    Velikost timeZoneName znak řetězec v bajtech.

  • [in] index
    Index jeden z názvů dvou časové pásmo k načtení.

Vrácená hodnota

Nula v případě úspěchu, jinak errno zadejte hodnotu.

Pokud timeZoneName je NULL, nebo sizeInBytes je nula, nebo menší než nula (ale nikoli obě), je vyvolána obslužná rutina neplatný parametr, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, tato funkce nastaví errno na EINVAL a vrátí EINVAL.

Chybové podmínky

pReturnValue

timeZoneName

sizeInBytes

index

Návratová hodnota

Obsah timeZoneName

Velikost Název TZ

NULL

0

0 nebo 1

0

nezměněno

Velikost Název TZ

any

> 0

0 nebo 1

0

Název TZ

nezměněno

NULL

> 0

any

EINVAL

nezměněno

nezměněno

any

nula

any

EINVAL

nezměněno

nezměněno

any

> 0

> 1

EINVAL

nezměněno

Poznámky

_get_tzname Funkce načte řetězcové reprezentace znaků název časového pásma nebo název zóny (běžný čas) letního času (DST) na adresu timeZoneName v závislosti na hodnotě indexu a velikost řetězce v pReturnValue.Pokud timeZoneName je NULL a sizeInBytes je nula velikost řetězce buď časové zóny v bajtech, které je vráceno v pReturnValue.Hodnoty indexu musí být pro standardní časové pásmo 0 nebo 1 pro letní standardní časové pásmo; hodnoty indexu mít neurčeného výsledky.

Hodnoty indexu

index

Obsah timeZoneName

timeZoneNameVýchozí hodnota

0

Název časového pásma

"PST"

1

Název zóny pro letní čas (běžný čas)

"PDT."

>1 nebo < 0

errnoChcete-li nastavitEINVAL

nezměněno

Není-li explicitně byly změněny hodnoty za běhu, výchozí hodnoty jsou "PST" a "PDT". Velikost pole těchto znaků se řídí TZNAME_MAX hodnotu.

Požadavky

Rutina

Požadované záhlaví

_get_tzname

<time.h>

Další informace naleznete v tématu Kompatibilita.

Ekvivalent v rozhraní .NET Framework

Nelze použít. Pokud chcete volat standardní funkci jazyka C, použijte PInvoke. Další informace naleznete v tématu Příklady vyvolání platformy.

Viz také

Referenční dokumentace

Správa času

errno, _doserrno, _sys_errlist, and _sys_nerr

_get_daylight

_get_dstbias

_get_timezone

TZNAME_MAX