strftime

[funkcja] Konwertuje strukturę _{» standard C ♦}tm na dowolnie sformatowaną datę lub czas.

Składnia

#include<ctime>
typedef long size_t;

size_t strftime(
char * pOutput,
size_t maxOutputSize,
const char * sFormat,
const struct tm * pTime
);

Opis szczegółowy

Funkcja konwertuje dane zawarte strukturze _{» standard C ♦}tm na dowolnie sformatowaną datę lub czas w postaci łańcucha znaków.

Formatowanie

Wszystkie znaki, które nie są poprzedzone znakiem % są kopiowane do bufora pOutput bez zmian. Znak % jest znakiem specjalnym i ma bezpośredni wpływ na znak po nim następujący. Kody formatujące są przedstawione w poniższej tabeli:

%a	Skrócona nazwa dnia tygodnia (np. Fri).
%A	Pełna nazwa dnia tygodnia (np. Friday).
%b	Skrócona nazwa miesiąca (np. Oct).
%B	Pełna nazwa miesiąca (np. October).
%c	Pełna data. (np. "03/24/10 02:40:31")
%d	Dzień miesiaca (przedział 1-31).
%H	Godzina w formacie 24 (0-23).
%I	Godzina w formacie 12 (1-12).
%j	Dzień roku (1-366).
%m	Numer miesiąca (1-12).
%M	Minuty (0-59).
%p	Pokazuje AM lub PM.
%S	Sekundy (0-59).
%U	Tydzień roku (0-53), pierwszy tydzień liczy się od pierwszej niedzieli.
%w	Dzień tygodnia (0-6), niedziela to 0.
%W	Tydzień roku (0-53), 1 to pierwszy poniedziałek.
%x	Liczbowo data (03/24/10).
%X	Liczbowo godzina (02:40:31).
%y	Rok w postaci dwucyfrowej (00-99).
%Y	Rok w postaci czterocyfrowej (np. 2010).
%Z	Strefa czasowa.
%%	Znak procenta.

Kody formatujące mogą również posiadać flagę #, która modyfikuje znaczenie wyżej wymienionych kodów formatujących. W poniższej tabeli zostało opisane znaczenie flagi dla każdego kodu formatującego:

Kod formatujący	Znaczenie
%#a, %#A, %#p, %#b, %#B, %#X, %#z, %#Z, %#%	Flaga # jest ignorowana (flaga nie zmienia znaczenia kodów formatujących).
%#c	Długa reprezentacja daty i czasu, zależna od aktualnych ustawień lokalnych. Przykładowo: "Wednesday, March 24, 2010 02:31:32".
%#x	Długa reprezentacja daty, zależna od aktualnych ustawień lokalnych. Przykładowo: "Wednesday, March 24, 2010".
%#H, %#d, %#j, %#I, %#m, %#M, %#S, %#w, %#W, %#U, %#y, %#Y	Usuwa niepotrzebne zera (jeśli jakieś występują).

Ustawienia lokalne mają wpływ na formatowane wyjście. Więcej informacji na ten temat w funkcji _{» standard C ♦}setlocale.

Argumenty

Nazwa argumentu	Opis
pOutput	Bufor wyjściowy.
maxOutputSize	Rozmiar bufora (maksymalna ilość znaków, jaka może zostać zapisana do bufora pOutput wliczając znak kończący null).
sFormat	Łańcuch znaków, określający sposób zaformatowania bufora wyjściowego.
pTime	Wskaźnik na strukturę _{» standard C ♦}tm.

Zwracana wartość

Zwraca liczbę znaków zapisanych w buforze wyjściowym pOutput.

Jeśli całkowita liczba znaków, która ma być zapisana w buforze wyjściowym (włącznie ze znakiem kończącym null) jest większa niż maxOutputSize funkcja zwróci wartość 0 i zawartość bufora wyjściowego jest nieokreślona.

Znak kończący łańcuch znaków nie jest wliczany do zwracanej wartości.

Przykład

#include <ctime>
#include <cstdio>
#include <clocale>
int main()
{
char bufor[ 64 ];
time_t czas;
time( & czas );
tm czasTM = * localtime( & czas );

strftime( bufor, sizeof( bufor ), "Obecna godzina to: %H:%M:%S", & czasTM );
printf( "[Zawartosc bufora]: \"%s\"\n", bufor );

setlocale( LC_ALL, "English" );
strftime( bufor, sizeof( bufor ), "Dzis jest: %#c", & czasTM );
printf( "[Zawartosc bufora]: \"%s\"\n", bufor );

setlocale( LC_ALL, "Polish" );
strftime( bufor, sizeof( bufor ), "Dzis jest: %#c", & czasTM );
printf( "[Zawartosc bufora]: \"%s\"\n", bufor );
return 0;
}

Przykładowe wyjście programu:

[Zawartosc bufora]: "Obecna godzina to: 02:39:16"
[Zawartosc bufora]: "Dzis jest: Wednesday, March 24, 2010 2:39:16 AM"
[Zawartosc bufora]: "Dzis jest: 24 marzec 2010 02:39:16"

Zagadnienia powiązane

tm	Przechowuje składowe daty i czasu w postaci liczb. (struktura)
asctime	Konwertuje strukturę _{» standard C ♦}tm na łańcuch znaków reprezentujący datę i czas. (funkcja)
ctime	Konwertuje _{» standard C ♦}time_t na łańcuch znaków reprezentujący datę i czas. (funkcja)
setlocale	(funkcja)

Linki zewnętrzne

http://www.cplusplus.com/reference/clibrary/ctime/strftime/

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.