Vous êtes dans : GNU/Linux Astuces / Pages man [Section3 - Sous-fonctions]

STRFTIME

Index

1. NOM
2. SYNOPSIS
3. DESCRIPTION
4. VALEUR RENVOYÉE
5. ENVIRONNEMENT
6. CONFORMITÉ
7. NOTES GLIBC
8. BOGUES
9. EXEMPLE
10. VOIR AUSSI
11. TRADUCTION

NOM

SYNOPSIS

#include <time.h>

size_t strftime (char *s, size_t max, const char *format,
                                const struct tm *tm);

DESCRIPTION

%a

Le nom abrégé du jour de la semaine, en fonction de la localisation en cours.

%A

Le nom complet du jour de la semaine, en fonction de la localisation en cours.

%b

Le nom abrégé du mois, en fonction de la localisation en cours.

%B

Le nom complet du mois, en fonction de la localisation en cours.

%c

La représentation classique de la date et de l'heure, suivant la localisation en cours.

%C

Le siècle (année/100) sous forme de nombre de deux chiffres. (SU)

%d

Le quantième du mois sous forme de nombre décimal (entre 01 et 31).

%D

Équivalent à %m/%d/%y. Seulement pour les américains. Ces derniers doivent noter que les autres pays préfèrent le format %d/%m/%y. Dans un contexte international, ce format est ambigu et doit être évité. (SU)

%e

Comme %d, le quantième du mois sous forme décimal, mais l'éventuel zéro en tête est remplacé par un espace. (SU)

%E

Modificateur : utiliser un format de rechange. Voir plus bas. (SU)

%F

Équivalent à %Y-%m-%d (format de date ISO 8601). (C99)

%G

L'année ISO 8601 (avec le siècle) comme nombre décimal. L'année sur quatre chiffres correspond au numéro de la semaine ISO (voir %V). C'est le même format que %y, sauf que si le numéro de semaine appartient à l'année suivante ou précédente, c'est celle-ci qui est affichée à la place. (TZ)

%g

Comme %G sans le siècle, c'est-à-dire avec une année sur deux chiffres (00-99). (TZ)

%h

Équivalent à %b. (SU)

%H

L'heure, sur 24 heures, sous forme de nombre décimal (entre 00 et 23).

%I

L'heure, sur 12 heures, sous forme de nombre décimal (entre 01 et 12).

%j

Le numéro du jour dans l'année (entre 001 et 366).

%k

L'heure (sur 24 heures) sous forme de nombre décimal (intervalle 0 à 23). Les chiffres uniques sont précédés d'un blanc (voir aussi %H). (TZ).

%l

L'heure (sur 12 heures) sous forme de nombre décimal (intervalle 1 à 12). Les chiffres uniques sont précédés d'un blanc (voir aussi %I). (TZ).

%m

Le numéro du mois (entre 01 et 12).

%M

La minute, sous forme de nombre décimal (00 à 59).

%n

Un caractère saut-de-ligne. (SU)

%O

Modificateur : utiliser un format de rechange. Voir plus bas. (SU)

%p

L'une des deux chaînes « AM » ou « PM » en fonction de l'heure, ou la traduction de ces chaînes en fonctions de la localisation en cours. Midi est traité comme « PM » et minuit comme « AM ».

%P

Comme %p mais en minuscule: « am » ou « pm » ou une chaîne locale équivalente. (GNU)

%r

L'heure en notation a.m. ou p.m. Dans la localisation POSIX, c'est équivalent à « %I:%M:%S %p ». (SU)

%R

L'heure en format 24 heures (%H:%M). (SU). Pour avoir les secondes voir %T.

%s

Le nombre de secondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC. (TZ).

%S

La seconde, sous forme de nombre décimal (00-60). L'intervalle peut être supérieur à 60 pour autoriser des secondes de rattrapage.

%t

Un caractère de tabulation. (SU)

%T

L'heure en notation 24 heures (%H:%M:%S). (SU)

%u

Le jour de la semaine sous forme décimal, de 1 (lundi) à 7. Voir aussi %w. (SU)

%U

Le numéro de la semaine dans l'année, sous forme de nombre décimal (00-53), en commençant le comptage au premier dimanche de l'année. Voir aussi %V et %W.

%V

Le numéro de semaine ISO 8601:1988 de l'année en cours sous forme de nombre décimal dans l'intervalle 01-53, où la semaine 1 est la première ayant au moins 4 jours dans l'année en cours, et où lundi est le premier jour de la semaine. Voir aussi %U et %W. (SU)

%w

Le numéro du jour de la semaine, sous forme décimale (0-6), dimanche valant 0. Voir aussi %u.

%W

Le numéro de la semaine dans l'année, sous forme de nombre décimal (00-53), en commençant le comptage au premier lundi de l'année.

%x

La représentation usuelle de la date, sans l'heure, dans la localisation en cours.

%X

La représentation usuelle de l'heure, sans la date, dans la localisation en cours.

%y

L'année, sous forme de nombre décimal, sans le siècle (entre 00 et 99).

%Y

L'année, sous forme de nombre décimal, incluant le siècle.

%z

Le fuseau horaire sous forme de décalage GMT. Nécessaire pour créer des dates conformes à la RFC 822 (avec "%a, %d %b %Y %H:%M:%S %z"). (GNU)

%Z

Le nom ou l'abréviation du fuseau horaire.

%+

La date et l'heure au format date(1). (TZ) (Non supporté par la glibc2)

%%

Un caractère « % ».

VALEUR RENVOYÉE

ENVIRONNEMENT

CONFORMITÉ

NOTES GLIBC

_

(souligné) Compléter une chaîne de résultat numérique avec des espaces.

-

(tiret) Ne pas compléter une chaîne de résultat numérique.

0

Compléter une chaîne de résultat numérique avec des zéros même si le caractère spécificateur de conversion utilise des espaces par défaut.

^

Convertir une chaîne alphabétique en une chaîne résultante en majuscule.

#

Échanger la casse de la chaîne résultat (cet attribut ne fonctionne qu'avec certains caractères spécificateurs de conversion, et parmi ceux-ci, il n'est vraiment utile qu'avec %Z).

BOGUES

size_t my_strftime(char *s, size_t max, const char *fmt, const struct tm *tm) {

  return strftime(s, max, fmt, tm);
}

EXEMPLE

#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 a renvoyé 0");
        exit(EXIT_FAILURE);
    }

    printf("La chaîne résultat est "%s"
", outstr);
    exit(EXIT_SUCCESS);
} /* main */

$ ./a.out "%m"
La chaîne résultat est "11"
$ ./a.out "%5m"
La chaîne résultat est "00011"
$ ./a.out "%_5m"
La chaîne résultat est "   11"

VOIR AUSSI

TRADUCTION