Sdílet prostřednictvím


_get_tzname

Načte řetězec reprezentace znaků název časového pásma nebo název zóny letní standardní čas (DST).

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

Parametry

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

  • [výstup]timeZoneName
    Adresa řetězec znaků pro znázornění časové pásmo název nebo název zóny letní standardní čas (DST) v závislosti na index.

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

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

Vrácená hodnota

Nula, pokud je úspěšná, jinak errno zadejte hodnotu.

Pokud timeZoneName je NULL, nebo sizeInBytes je nulové nebo menší než nula (ale ne obě), je vyvolána obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, tato funkce nastaví errno na EINVAL a vrátí EINVAL.

Chybové podmínky

pReturnValue

timeZoneName

sizeInBytes

index

Vrácená hodnota

ObsahtimeZoneName

velikost názvu TZ

NULL

0

0 nebo 1

0

Nezměněno

velikost názvu TZ

žádné

> 0

0 nebo 1

0

Název TZ

Nezměněno

NULL

> 0

žádné

EINVAL

Nezměněno

Nezměněno

žádné

nula

žádné

EINVAL

Nezměněno

Nezměněno

žádné

> 0

> 1

EINVAL

Nezměněno

Poznámky

_get_tzname Funkce načte řetězec reprezentace znaků název časového pásma nebo název zóny letní standardní čas (DST) do adresy timeZoneName v závislosti na hodnotě indexu spolu s velikost řetězce v pReturnValue.Pokud timeZoneName je NULL a sizeInBytes je nula, stačí velikost řetězce buď časové pásmo v bajtech je vrácena 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

ObsahtimeZoneName

timeZoneNameVýchozí hodnota

0

Název časového pásma

"PST"

1

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

"PDT"

> 1 nebo < 0

errnonastavitEINVAL

Nezměněno

Pokud není výslovně změně hodnot v době spuštění, výchozí hodnoty jsou "PST" a "PDT".Velikosti polí 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 Použijte volání funkce standardní C, PInvoke. Další informace naleznete v tématu Příklady vyvolat platformu.

Viz také

Referenční dokumentace

Aplikace Správa času

Kód chyby, _doserrno, _sys_errlist a _sys_nerr

_get_daylight

_get_dstbias

_get_timezone

TZNAME_MAX