strftime(3) - Japanese

%G, %g, %V は、ISO 8601 標準により定義された週単位表記の年により 計算される値を出力する。 ISO 8601 標準の週単位表記では、週は月曜日から開始され、 週番号は、年の最初の週が 01 となり、最後の週は 52 か 53 となる。 週 01 は、新しい年が 4 日以上含まれる最初の週である。 言い換えると、週 01 は、その年の木曜日を含む最初の週、 つまり 1 月 4 日を含む週ということである。 新しい年のカレンダー上の最初の週に新しい年が 3 日以下しか含まれない場合、 ISO 8601 の週単位表記では、これらの日を前の年の週 53 の一部とみなす。 例えば、2010 年 1 月 1 日は金曜日であり、 その週には 2010 年の日が 3 日しか含まれない。 したがって、ISO 8601 の週単位表記では、これらの日は 2009 年 (%G) の週 53 (%V) の一部となる。 ISO 8601 の 2010 年の週 01 は 2010 年 1 月 4 日の月曜日から始まる。

glibc では変換指定にいくつか拡張を行っている (これらの拡張は POSIX.1-2001 には規定されていないが、 他のいくつかのシステムで同様の機能が提供されている)。 \(aq%\(aq 文字と変換指定文字の間に、オプションとして flag とフィールドの 幅 を指定できる (これらを指定する場合には E や O 修飾子の前に置く)。

_	(下線) 数値の結果文字列のパディング (穴埋め) をスペース (空白文字) で行う。
-	(ダッシュ) 数値の結果文字列に対するパディングを行わない。
0	変換指定文字がデフォルトではスペースでパディングを行う場合でも、 数値の結果文字列へのパディングを 0 で行う。
^	結果文字列中のアルファベット文字を大文字に変換する。
#	結果文字列の大文字・小文字を入れ替える (このフラグは特定の変換指定文字でしか機能しない。その中でも 本当に有用なのは %Z の場合だけである)。

オプションの10進数の幅指定子はフラグの後ろに置くことができる (フラグはなくてもよい)。フィールドの本来の大きさが指定された幅よりも 小さい場合、結果文字列の左側は指定された幅までパディングされる。

以下のプログラムを使うと strftime() の実験ができる。

$ ./a.out \(aq%m\(aq
Result string is "11"
$ ./a.out \(aq%5m\(aq
Result string is "00011"
$ ./a.out \(aq%_5m\(aq
Result string is "   11"

#include <time.h>
#include <stdio.h>
#include <stdlib.h>


int
main(int argc, char *argv[])
{
    char outstr[200];
    time_t t;
    struct tm *tmp;


    t = time(NULL);
    tmp = localtime(&t);
    if (tmp == NULL) {
        perror("localtime");
        exit(EXIT_FAILURE);
    }


    if (strftime(outstr, sizeof(outstr), argv[1], tmp) == 0) {
        fprintf(stderr, "strftime returned 0");
        exit(EXIT_FAILURE);
    }


    printf("Result string is \"%s\"\n", outstr);
    exit(EXIT_SUCCESS);
}