Spec-Zone.ru › C++

std::wcsftime

Определено в заголовке <cwchar>
std::size_t wcsftime( wchar_t* str, std::size_t count, const wchar_t* format, const std::tm* time );

Преобразует информацию о дате и времени из заданного времени календаря time в строку широких символов с нулевым завершением str в соответствии со строкой формата строка формата format. Записывается до count широких символов.

Параметры

str - указатель на первый элемент массива wchar_t для вывода
count - максимальное количество широких символов для записи
format - указатель на строку широких символов с нулевым завершением, определяющую формат преобразования
time - указатель на информацию о дате и времени, подлежащую преобразованию

Строка формата

Строка формата состоит из нуля или более спецификаторов преобразования и обычных символов (кроме %). Все обычные символы, включая завершающий нулевой символ, копируются в строку вывода без изменений. Каждый спецификатор преобразования начинается с символа %, необязательно после которого следует E или O модификатор (игнорируется, если не поддерживается локалью), за которым следует символ, определяющий поведение спецификатора. Доступны следующие спецификаторы формата:

Спецификатор преобразования
Объяснение Используемые поля
% выводит литерал %. Полная спецификация преобразования должна быть %%.
n
(C++11)
выводит символ новой строки
t
(C++11)
выводит символ горизонтальной табуляции
Год
Y выводит год как десятичное число, например, 2017 tm_year
EY
(C++11)
выводит год в альтернативной форме, например, 平成23年 (год Хэйсэй 23) вместо 2011年 (год 2011) в локали ja_JP tm_year
y выводит последние 2 цифры года как десятичное число (диапазон [00,99]) tm_year
Oy
(C++11)
выводит последние 2 цифры года с использованием альтернативной числовой системы, например, 十一 вместо 11 в локали ja_JP tm_year
Ey
(C++11)
выводит год как смещение от альтернативного периода календаря локали %EC (зависит от локали) tm_year
C
(C++11)
выводит первые 2 цифры года как десятичное число (диапазон [00,99]) tm_year
EC
(C++11)
выводит год по ISO 8601, содержащий указанную неделю.

В ISO 8601 недели начинаются с понедельника, а первая неделя года должна удовлетворять следующим требованиям:

  • Включает 4 января
  • Включает первый четверг года
tm_year, tm_wday, tm_yday
g
(C++11)
выводит последние 2 цифры года по ISO 8601, содержащего указанную неделю (диапазон [00,99]).

В ISO 8601 недели начинаются с понедельника, а первая неделя года должна удовлетворять следующим требованиям:

  • Включает 4 января
  • Включает первый четверг года
tm_year, tm_wday, tm_yday
Месяц
b выводит сокращенное название месяца, например, Oct (зависит от локали) tm_mon
h
(C++11)
синоним b tm_mon
B выводит полное название месяца, например, October (зависит от локали) tm_mon
m выводит месяц как десятичное число (диапазон [01,12]) tm_mon
Om
(C++11)
выводит месяц с использованием альтернативной числовой системы, например, 十二 вместо 12 в локали ja_JP tm_mon
Неделя
U выводит номер недели в году как десятичное число (воскресенье — первый день недели) (диапазон [00,53]) tm_year, tm_wday, tm_yday
OU
(C++11)
выводит номер недели в году, как и %U, с использованием альтернативной числовой системы, например, 五十二 вместо 52 в локали ja_JP tm_year, tm_wday, tm_yday
W выводит номер недели в году как десятичное число (понедельник — первый день недели) (диапазон [00,53]) tm_year, tm_wday, tm_yday
OW
(C++11)
выводит номер недели в году, как и %W, с использованием альтернативной числовой системы, например, 五十二 вместо 52 в локали ja_JP tm_year, tm_wday, tm_yday
V
(C++11)
выводит номер недели в году по ISO 8601 (диапазон [01,53]).

В ISO 8601 недели начинаются с понедельника, а первая неделя года должна удовлетворять следующим требованиям:

  • Включает 4 января
  • Включает первый четверг года
tm_year, tm_wday, tm_yday
OV
(C++11)
выводит номер недели в году, как и %V, с использованием альтернативной числовой системы, например, 五十二 вместо 52 в локали ja_JP tm_year, tm_wday, tm_yday
День года/месяца
j выводит день года как десятичное число (диапазон [001,366]) tm_yday
d выводит день месяца как десятичное число (диапазон [01,31]) tm_mday
Od
(C++11)
выводит день месяца, нулевой отсчёт, с использованием альтернативной числовой системы, например, 二十七 вместо 27 в локали ja_JP

Односимвольное значение предваряется пробелом.

tm_mday
e
(C++11)
выводит день месяца как десятичное число (диапазон [1,31]).

Однозначное значение предваряется пробелом.

tm_mday
Oe
(C++11)
выводит день месяца, единичный отсчёт, с использованием альтернативной числовой системы, например, 二十七 вместо 27 в локали ja_JP

Односимвольное значение предваряется пробелом.

tm_mday
День недели
a выводит сокращенное название дня недели, например, Fri (зависит от локали) tm_wday
A выводит полное название дня недели, например, Friday (зависит от локали) tm_wday
w выводит день недели как десятичное число, где воскресенье — 0 (диапазон [0-6]) tm_wday
Ow
(C++11)
выводит день недели, где воскресенье — 0, с использованием альтернативной числовой системы, например, 二 вместо 2 в локали ja_JP tm_wday
u
(C++11)
выводит день недели как десятичное число, где понедельник — 1 (формат ISO 8601) (диапазон [1-7]) tm_wday
Ou
(C++11)
выводит день недели, где понедельник — 1, с использованием альтернативной числовой системы, например, 二 вместо 2 в локали ja_JP tm_wday
Час, минута, секунда
H выводит час как десятичное число, 24-часовой формат (диапазон [00-23]) tm_hour
OH
(C++11)
выводит час из 24-часового формата с использованием альтернативной числовой системы, например, 十八 вместо 18 в локали ja_JP tm_hour
I выводит час как десятичное число, 12-часовой формат (диапазон [01,12]) tm_hour
OI
(C++11)
выводит час из 12-часового формата с использованием альтернативной числовой системы, например, 六 вместо 06 в локали ja_JP tm_hour
M выводит минуту как десятичное число (диапазон [00,59]) tm_min
OM
(C++11)
выводит минуту с использованием альтернативной числовой системы, например, 二十五 вместо 25 в локали ja_JP tm_min
S выводит секунду как десятичное число (диапазон [00,60]) tm_sec
OS
(C++11)
выводит секунду с использованием альтернативной числовой системы, например, 二十四 вместо 24 в локали ja_JP tm_sec
Другое
c выводит стандартную строку даты и времени, например, Sun Oct 17 04:41:13 2010 (зависит от локали) все
Ec
(C++11)
выводит альтернативную строку даты и времени, например, используя 平成23年 (год Хэйсэй 23) вместо 2011年 (год 2011) в локали ja_JP все
x выводит локализованное представление даты (зависит от локали) все
Ex
(C++11)
записывает альтернативное представление даты, например, используя 平成23年 (год Хэйсэй 23) вместо 2011年 (год 2011) в локали ja_JP все
X записывает локализованное представление времени, например, 18:40:20 или 6:40:20 PM (зависит от локали) все
EX
(C++11)
записывает альтернативное представление времени (зависит от локали) все
D
(C++11)
эквивалентно "%m/%d/%y" tm_mon, tm_mday, tm_year
F
(C++11)
эквивалентно "%Y-%m-%d" (формат даты ISO 8601) tm_mon, tm_mday, tm_year
r
(C++11)
записывает локализованное время в 12-часовом формате (зависит от локали) tm_hour, tm_min, tm_sec
R
(C++11)
эквивалентно "%H:%M" tm_hour, tm_min
T
(C++11)
эквивалентно "%H:%M:%S" (формат времени ISO 8601) tm_hour, tm_min, tm_sec
p записывает локализованные обозначения до или после полудня (зависит от локали) tm_hour
z
(C++11)
записывает смещение от UTC в формате ISO 8601 (например, -0430), или пустую строку, если информация о часовом поясе недоступна tm_isdst
Z записывает имя или сокращение часового пояса, зависящее от локали, или пустую строку, если информация о часовом поясе недоступна tm_isdst

Возвращаемое значение

Количество широких символов, записанных в массив широких символов, указанный по адресу str, не считая завершающего L'\0' при успешном выполнении. Если count был достигнут до того, как вся строка могла быть записана, возвращается ​0​, а содержимое неопределенно.

Пример

#include <ctime>
#include <cwchar>
#include <iostream>
#include <locale>
 
int main()
{
    std::locale::global(std::locale("ja_JP.utf8"));
    std::time_t t = std::time(nullptr);
    wchar_t wstr[100];
    if (std::wcsftime(wstr, 100, L"%A %c", std::localtime(&t)))
        std::wcout << wstr << '\n';
}

Возможный вывод:

火曜日 2011年12月27日 17時43分13秒

См. также

strftime
преобразует объект std::tm в пользовательское текстовое представление
(функция)
put_time
(C++11)
форматирует и выводит значение даты/времени в соответствии с указанным форматом
(шаблон функции)
C документация для wcsftime

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/chrono/c/wcsftime

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API