_get_tzname
タイム ゾーン名または夏の標準タイム ゾーンの名前 (DST) の文字列表現を取得します。
errno_t _get_tzname(
size_t* pReturnValue,
char* timeZoneName,
size_t sizeInBytes,
int index
);
パラメーター
[出力] pReturnValue
null 終端文字を含む timeZoneName の文字列長。[出力] timeZoneName
index によるタイム ゾーンの名前または夏の標準タイム ゾーンの名前 (DST) 表現の文字列のアドレス。[入力] sizeInBytes
バイト timeZoneName の文字列です。[入力] index
取得する 2 とおりのタイム ゾーン名の 1 種類のインデックス。
戻り値
は型の値 errno 成功した場合は。
timeZoneName が NULL であるかまたは sizeInBytes がゼロまたは未満 (ただし両方) の場合無効なパラメーター ハンドラーが パラメーターの検証 に説明されているように開始されます。実行の継続が許可された場合関数のセット errno は EINVAL を返しEINVALこの。
エラー条件
pReturnValue |
timeZoneName |
sizeInBytes |
index |
戻り値 |
timeZoneName の内容 |
|---|---|---|---|---|---|
TZ の名前のサイズ |
NULL |
0 |
0 または 1 |
0 |
変更されない |
TZ の名前のサイズ |
任意 |
> 0 |
0 または 1 |
0 |
TZ が見つかりました。 |
変更されない |
NULL |
> 0 |
任意 |
EINVAL |
変更されない |
変更されない |
任意 |
0 |
任意 |
EINVAL |
変更されない |
変更されない |
任意 |
> 0 |
> 1 |
EINVAL |
変更されない |
解説
_get_tzname の関数は pReturnValue の文字列のサイズとともにインデックス値で timeZoneName のアドレスにタイム ゾーンの名前または夏の標準タイム ゾーンの名前 (DST) の文字列表現を取得します。timeZoneName が NULL でsizeInBytes がゼロの場合バイトのいずれかのタイム ゾーンの一連のサイズはpReturnValue に返されます。インデックス値は標準タイム ゾーンの夏または 0 の標準タイム ゾーンの 1 に ; インデックスの他の値には不定の結果があります。
インデックス値
index |
timeZoneName の内容 |
timeZoneName の既定値 |
|---|---|---|
0 |
タイム ゾーン名 |
「」 PST |
1 |
中部標準時タイムラインの名前 |
「」 PDT |
> 1 または 0 < |
EINVAL への errno の設定 |
変更されない |
値が実行時に明示的に変更されていない場合既定値は 「 PST 」「および " 」 PDT です。これらの文字配列のサイズは TZNAME_MAX の値によって決まります。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_get_tzname |
<time.h> |
詳細については、「互換性」を参照してください。
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。