Многие из флагов формата, которые эта новая система использует для вывода, используютсяstrftime, но не все. Некоторые новые флаги были добавлены, а другие отменены. Система ввода поддерживает только определенные флаги, поэтому не все флаги, которые работают на выходе, будут работать с входом (в настоящее время мы работаем над исправлением этой ситуации).

В следующих таблицах перечислены все флаги, доступные для ввода-вывода date_time, а также strftime. Флаги формата, отмеченные одной звездочкой (*), имеют поведение, уникальное для date_time. Эти флаги, отмеченные восклицательным знаком (!), не могут использоваться для ввода (в настоящее время). Флаги, помеченные знаком хеширования (#), реализуются локальной системой и, как известно, отсутствуют на некоторых платформах. Первая таблица относится к датам, а вторая таблица — к временам.

Date Facet Format Flags

%a

«Мон» =>Понедельник

%A

«Понедельник»

%b

«Февраль» =>Февраль

%B

«Февраль»

%c !

%C !#

%d

%D !#

%e #

%G !

%g !

%h !#

%j

«060» =>29 февраля

%m

«01» =>январь

%u !

%U

дата d(2005, январь, 1); // Суббота // с форматом %U ss<

%V !#

%w

«0» =>Воскресенье

%W

дата d(2005, январь, 2); // воскресенье // с форматом %W ss<

%x

date d(2005,Oct,31); date_facet* f = new date_facet("%x"); locale loc = locale(locale("en_US"), f); cout.imbue(loc); cout<

%y

"05" =>2005

%Y

"2005"

%Y-%b-%d

"2005-Апрель-01"

%Y%m%d

"20050401"

%Y-%m-%d

"2005-04-01"

Флаги формата Time Facet

%- *!

"-13:15:16"

%+ *!

"+13:15:16"

%f

"13:15:16.000000"

%F *

"13:15:16" "05:04:03.001234"

%H

%I !

%k !

%l !

%M

%O

%p !

%P !#

%r !#

%R !

%s *

"59.000000"

%S

"59"

%T !

%q

"-0700" // Горное стандартное время

%Q

"-05:00" // Восточное стандартное время

%z *!

«MST» // Горное стандартное время

%Z *!

«ЭДТ» // Восточное светлое время

%ZP *

"EST-05EDT+01,M4.1.0/02:00,M10.5.0/02:00"

%x %X

Дата d(2005,Oct,31); ptime pt(d, hours(20)); time_facet* f = new time_facet("%x%X"); locale loc = locale("en_US"), f); cout.imbue(loc); cout<< pt. "10/31/2005 08:00:00 PM" loc = locale(locale("de_DE"), f); cout.imbue(loc); cout<< pt; // "31.10.2005 20:00:00"

%Y%m%dT%H%M%S%F%q

"20051015T131211-0700" // 15 октября 2005 13:12:11 MST

%Y-%m-%d %H:%M:%S%F%Q

"2005-10-15 13:12:11-07:00"

%Y-%b-%d %H:%M:%S%F %z

«2005-Окт-15 13:12:11 MST»

%Y-%b-%d %H:%M:%S%F %ZP

«2005-Окт-15 13:12:11 MST-07»

%-%H:%M:%S%F !

"-13:14:15.003400"

%H:%M:%S%F

«13:14:15.003400»

* Флаги с уникальным поведениемdate_time.

# Флаги, которые имеют зависимое от платформы поведение. Их не везде можно поддержать.

! Флаги, которые в настоящее время не работают для ввода.

Introduction

Повышение::date_time::date_facetпозволяет пользователям иметь значительный контроль над потоковой передачей дат на выходе (и других григорианских объектов). Дата_facet типизирована вгригорианскомпространстве имен какдата_facetиwdate_facet.

Construction

date_facet()

date_facet(...)
  Parameters:
    char_type* format
    input_collection_type

date_facet(...)
  Parameters:
    char_type* format
    period_formatter_type
    special_values_formatter_type
    date_gen_formatter_type

Accessors

void format(char_type*)

date_facet* f = new date_facet(); f->format("%m %d %Y");

void set_iso_format()

f->set_iso_format(); // "%Y%m%d"

void set_iso_extended_format()

f->set_iso_extended_format(); // "%Y-%m-%d"

void month_format(char_type*)

f->month_format("%B"); ss<< greg_month(12); // "Декабрь"

void weekday_format(char_type*)

f->weekday_format("%a"); ss<< greg_weekday(2); // "Tue"

void period_formatter(...)
  Parameter:
    period_formatter_type

void special_values_formatter(...)
  Parameter:
    special_values_formatter_type

void date_gen_phrase_strings(...)
  Parameters:
    input_collection_type
    date_gen_formatter_type::
      phrase_elements

void short_weekday_names(...)
  Parameter:
    input_collection_type

void long_weekday_names(...)
  Parameter:
    input_collection_type

void short_month_names(...)
  Parameter:
    input_collection_type

void long_month_names(...)
  Parameter:
    input_collection_type

OutItrT put(...)
  Common parameters for all 
  'put' functions:
    OutItrT 
    ios_base
    char_type
  Unique parameter for 'put' funcs:
    gregorian object

OutItrT put(..., date)

OutItrT put(..., days)

OutItrT put(..., month)

OutItrT put(..., day)

«01» // 1 января

OutItrT put(..., day_of_week)

OutItrT put(..., date_period)

OutItrT put(..., partial_date)

"01 Ян" // форматы по умолчанию "01 Январь" // формат длинного месяца

OutItrT put(..., date_generator)
  Date Generator Type:
    nth_day_of_the_week_in_month

«третий фри в мае» // дефолты

OutItrT put(..., date_generator)
  Date Generator Type:
    first_day_of_the_week_in_month

«Свадьба первого июня» // дефолты

OutItrT put(..., date_generator)
  Date Generator Type:
    last_day_of_the_week_in_month

«Последний Тю Мар» // дефолты

OutItrT put(..., date_generator)
  Date Generator Type:
    first_day_of_the_week_after

«Первый Сат после» // дефолты

OutItrT put(..., date_generator)
  Date Generator Type:
    first_day_of_the_week_before

«первый месяц до» // дефолты

Introduction

Повышение::date_time:::date_input_facetпозволяет пользователям иметь значительный контроль над тем, как даты (и другие грегорианские объекты) передаются в потоковом режиме. Дата_input_facet типизирована вгригорианскомпространстве имен какдата_input_facetиwdate_input_facet.

Construction

date_input_facet()

date_input_facet(string_type format)

date_input_facet(...)
  Parameters:
    string_type format
    format_date_parser_type
    special_values_parser_type
    period_parser_type
    date_gen_parser_type

Accessors

void format(char_type*)

date_input_facet* f = new date_input_facet(); f->format("%m %d %Y");

void set_iso_format()

f->set_iso_format(); // "%Y%m%d"

void set_iso_extended_format()

f->set_iso_extended_format(); // "%Y-%m-%d"

void month_format(char_type*)

f->month_format("%B"); ss.str("March"); ss>>m; // March

void weekday_format(char_type*)

f->weekday_format("%a"); ss.str("Sun"); ss>>wd; // Sunday

void year_format(char_type*)

f->weekday_format("%y"); ss.str("04"); ss>>год; // 2004

void period_parser(...)
  Parameter:
    period_parser_type

void special_values_parser(...)
  Parameter:
    special_values_parser_type

void date_gen_phrase_strings(...)
  Parameters:
    input_collection_type

void short_weekday_names(...)
  Parameter:
    input_collection_type

void long_weekday_names(...)
  Parameter:
    input_collection_type

void short_month_names(...)
  Parameter:
    input_collection_type

void long_month_names(...)
  Parameter:
    input_collection_type

InItrT get(...)
  Common parameters for all 
  'get' functions:
    InItrT from
    InItrT to
    ios_base
  Unique parameter for 'get' funcs:
    gregorian object

InItrT get(..., date)

ss.str("2005-Jan-01"); ss>>d; // формат по умолчанию

InItrT get(..., month)

ss.str("Feb"); ss>>m; // формат по умолчанию

InItrT get(..., day_of_week)

ss.str("Sun"); ss>>dow; // формат по умолчанию

InItrT get(..., day)

«01» // 1 января

InItrT get(..., year)

ss/str("2005"); ss>>y; // формат по умолчанию

InItrT get(..., days)

ss.str("356"); ss >>dys; // полный год

InItrT get(..., date_period)

InItrT get(..., partial_date)

"01 Ян" // форматы по умолчанию "01 Январь" // формат длинного месяца

InItrT get(..., date_generator)
  Date Generator Type:
    nth_day_of_the_week_in_month

«третий фри в мае» // дефолты

InItrT get(..., date_generator)
  Date Generator Type:
    first_day_of_the_week_in_month

«Свадьба первого июня» // дефолты

InItrT get(..., date_generator)
  Date Generator Type:
    last_day_of_the_week_in_month

«Последний Тю Мар» // дефолты

InItrT get(..., date_generator)
  Date Generator Type:
    first_day_of_the_week_after

«Первый Сат после» // дефолты

InItrT get(..., date_generator)
  Date Generator Type:
    first_day_of_the_week_before

«первый месяц до» // дефолты

Introduction

boost::date_time::time_facetявляется расширениемboost::date_time::date_facet. Time_facet типизирован в пространстве именposix_timeкакtime_facetиwtime_facet. Он типизирован в пространстве именlocal_timeкакlocal_time_facetиwlocal_time_facet.

Construction

time_facet()

time_facet(...)
  Parameters:
    char_type* format
    period_formatter_type
    special_values_formatter_type
    date_gen_formatter_type

Accessors

Time_facet наследует все публичные методы date_facet. Поэтому методы date_facet здесь не перечислены. Вместо этого их можно найти, перейдя по ссылке.

void time_duration_format(...)
  Parameter:
    char_type*

f->time_duration_format("%+%H:%M"); // только часы и минуты w/знак всегда отображал time_duration td1(3, 15, 56); time_duration td2(-12, 25, 32); ss<< td1; // "+03:15:56" ss<< td2; // "-12:25:56"

void set_iso_format()

f->set_iso_format(); // "%Y%m%dT%H%M%S%F%q"

void set_iso_extended_format()

f->set_iso_extended_format(); // «%Y-%m-%d %H:%M:%S%F%Q»

OutItrT put(...)
  Common parameters for all 
  'put' functions:
    OutItrT 
    ios_base
    char_type
  Unique parameter for 'put' funcs:
    posix_time object

OutItrT put(..., ptime)

OutItrT put(..., time_duration)

OutItrT put(..., time_period)

Introduction

boost::date_time::time_input_facetявляется расширениемdate_input_facet. Он типизирован в бустере::posix_timenamespace какtime_input_facetиwtime_input_facet. Он типизирован в бустере::local_timenamespace какlocal_time_input_facetиwlocal_time_input_facet.

Construction

time_input_facet()

time_input_facet(string_type)

time_input_facet(...)
  Parameters:
    string_type format
    format_date_parser_type
    special_values_parser_type
    period_parser_type
    date_gen_parser_type

Accessors

Time_input_facet наследует все общедоступные методы date_input_facet. Поэтому методы date_input_facet здесь не перечислены. Вместо этого их можно найти по ссылке.

void set_iso_format()

f->set_iso_format(); // "%Y%m%dT%H%M%S%F%q" "20051225T132536.789-0700"

void set_iso_extended_format()

f>set_iso_extended_format(); // "%Y-%m-%d" %H:%M:%S%F %Q» «2005-12-25 13:25:36.789 -07:00»

void time_duration_format(...)
  Parameter:
    char_type*

f->time_duration_format("%H:%M"); // только часы и минуты

InItrT get(...)
  Common parameters for all 
  'get' functions:
    InItrT from
    InItrT to
    ios_base
  Unique parameter for 'get' funcs:
    gregorian object

InItrT get(..., ptime)

ss.str("2005-Jan-01 13:12:01"); ss >>pt; // формат по умолчанию

InItrT get(..., time_duration)

ss.str("01:25:15.000123000"); ss>>td; // формат по умолчанию

InItrT get(..., time_period)

Date Time Formatter/Parser Objects

Periods

Period_formatter и period_parser обеспечивают единый интерфейс для ввода и вывода date_periods, time_periods и в будущем выпуске local_date_time_periods. Пользователь имеет контроль над разграничителями, форматами компонентов даты/времени и формой периода. Формат компонентов даты/времени контролируется через элементы ввода и вывода даты_времени.

Period Form

Периоды строятся с открытыми параметрами. Первое значение является отправной точкой и включается в период. Конечное значение не включается, но сразу следует за последним значением: [начало/конец]. Тем не менее, период можно транслировать как открытый диапазон или закрытый диапазон.

[2003-Jan-01/2003-Dec-31] <-- period holding 365 days
[2003-Jan-01/2004-Jan-01) <-- period holding 365 days

Delimiters

Есть четыре разграничителя. Значения по умолчанию являются

Пользователь может предоставить пользовательский набор разграничителей. Пользовательские разграничители могут содержать пробелы.

Customization

Форма периода и разграничители могут быть установлены в качестве параметров конструкции или с помощью функций аксессуара. Пользовательский парсер / формататор периода может затем использоваться в качестве параметра конструкции для нового аспекта или может быть установлен в существующем аспекте с помощью функции доступа.

Period Formatter/Parser Reference

Period Formatter Construction

period_formatter(...)
  Parameters:
    range_display_options
    char_type*
    char_type*
    char_type*
    char_type*

Period Formatter Accessors

range_display_options range_option()

void range_option(...)
  Parameter:
    range_display_options

void delimiter_strings(...)
  Parameters:
    string_type
    string_type
    string_type
    string_type

строка beg("->|"); строка sep(" | |"); строка opn(" ->|"); строка clo(" |<-"); pf.delimiter_strings(beg, sep, opn, clo);

put_period_start_delimeter(...)
  Return Type:
    OutItrT
  Parameter:
    OutItrT

put_period_sepatator(...)
  Return Type:
    OutItrT
  Parameter:
    OutItrT

put_period_end_delimeter(...)
  Return Type:
    OutItrT
  Parameter:
    OutItrT

OutItrT put_period(...)
  Parameters:
    OutItrT
    ios_base
    char_type
    period_type
    facet_type

Period Parser Construction

period_parser(...)
  Parameters:
    period_range_option
    char_type*
    char_type*
    char_type*
    char_type*

period_parser(period_parser)

Period Parser Accessors

period_range_option range_option()

void range_option(...)
  Parameter:
    period_range_option 

void delimiter_strings(...)
  Parameters:
    string_type
    string_type
    string_type
    string_type

строка beg("->|"); строка sep(" | |"); строка opn(" ->|"); строка clo(" |<-"); pp.delimiter_strings(beg, sep, opn, clo);

collection_type delimiter_strings()

period_type get_period(...)
  Parameters:
    stream_itr_type
    stream_itr_type
    ios_base
    period_type
    duration_type
    facet_type

________________________________________

Date Generators

Формататор и парсер date_generator обеспечивают гибкость, позволяя пользователю использовать пользовательские «элементы фразы». Эти элементы фразы являются промежуточными словами в генераторах дат. Например, в date_generator "Второй понедельник марта", "Второй" и "Второй" - элементы фразы, где "Понедельник" и "Март" - элементы даты. Настройка элементов даты производится с гранью. Порядок даты и элементы фразы изменить нельзя. При разборе все элементы фразы date_generator должны быть правильно разобраны или ios_base:

Customization

По умолчанию «phrase_strings»:

Пользовательский набор фраз_струн должен поддерживать этот порядок возникновения (Ex: «1-я», «2-я», «3-я», «4-я», «5-я», «последняя», «предыдущая», «прошлая», «в»).

Примеры использования фразы по умолчанию_strings и форматов по умолчанию для будни и месяца:

"first Tue of Mar"

И используя пользовательскую фразу_строк:

"1st Tue in Mar"

Настраиваемый набор элементов фразы может быть установлен в качестве параметров конструкции или через функцию доступа. Пользовательский парсер/форматер date_generator может быть использован в качестве конструктивного параметра для нового аспекта или может быть установлен в существующем аспекте с помощью функции доступа.

ВАЖНОЕ ПРИМЕЧАНИЕ: До 1.33, неполная дата была выведена как «1 Ян» с одним * или * двузначным числом для дня. Новое поведение заключается в том, чтобы *всегда* помещать двузначное число на день - "01 января".

Date Generator Reference

Date Generator Formatter Construction

date_generator_formatter()

date_generator_formatter(...)
  Parameters:
    string_type first_element
    string_type second_element
    string_type third_element
    string_type fourth_element
    string_type fifth_element
    string_type last_element
    string_type before_element
    string_type after_element
    string_type of_element

Date Generator Formatter Accessors

void elements(...)
  Parameters:
    collection_type
    phrase_elements

// col представляет собой коллекционный холдинг // «финал», «приор», «следующий», // и «в» typedef date_generator_formatter dgf; dgf formatter(); formatter.elements(col, dgf::last); // полными элементами в dgf являются теперь: «первый», «второй», «третий», «четвертый», «пятый», «финал», «приор», «следующий» и «в»

put_partial_date(...)
  Return Type:
    facet_type::OutItrT
  Parameters:
    OutItrT next
    ios_base
    char_type fill
    partial_date
    facet_type

put_nth_kday(...)
  Return Type:
    facet_type::OutItrT
  Parameters:
    OutItrT next
    ios_base
    char_type fill
    nth_kday_type
    facet_type

put_first_kday(...)
  Return Type:
    facet_type::OutItrT
  Parameters:
    OutItrT next
    ios_base
    char_type fill
    first_kday_type
    facet_type

put_last_kday(...)
  Return Type:
    facet_type::OutItrT
  Parameters:
    OutItrT next
    ios_base
    char_type fill
    last_kday_type
    facet_type

put_kday_before(...)
  Return Type:
    facet_type::OutItrT
  Parameters:
    OutItrT next
    ios_base
    char_type fill
    kday_before_type
    facet_type

put_kday_after(...)
  Return Type:
    facet_type::OutItrT
  Parameters:
    OutItrT next
    ios_base
    char_type fill
    kday_after_type
    facet_type

Date Generator Parser Construction

date_generator_parser()

date_generator_parser(...)
  Parameter:
    date_generator_parser

date_generator_parser(...)
  Parameters:
    string_type first_element
    string_type second_element
    string_type third_element
    string_type fourth_element
    string_type fifth_element
    string_type last_element
    string_type before_element
    string_type after_element
    string_type of_element

Date Generator Parser Accessors

void element_strings(...)
  Parameter:
    collection_type

void element_strings(...)
  Parameters:
    string_type first
    string_type second
    string_type third
    string_type fourth
    string_type fifth
    string_type last
    string_type before
    string_type after
    string_type of

get_partial_date_type(...)
  Return Type:
    facet_type::partial_date_type
  Parameters:
    stream_itr_type next
    stream_itr_type str_end
    ios_base
    facet_type

get_nth_kday_type(...)
  Return Type:
    facet_type::nth_kday_type
  Parameters:
    stream_itr_type next
    stream_itr_type str_end
    ios_base
    facet_type

get_first_kday_type(...)
  Return Type:
    facet_type::firat_kday_type
  Parameters:
    stream_itr_type next
    stream_itr_type str_end
    ios_base
    facet_type

get_last_kday_type(...)
  Return Type:
    facet_type::last_kday_type
  Parameters:
    stream_itr_type next
    stream_itr_type str_end
    ios_base
    facet_type

get_kday_before_type(...)
  Return Type:
    facet_type::kday_before_type
  Parameters:
    stream_itr_type next
    stream_itr_type str_end
    ios_base
    facet_type

get_kday_after_type(...)
  Return Type:
    facet_type::kday_after_type
  Parameters:
    stream_itr_type next
    stream_itr_type str_end
    ios_base
    facet_type

________________________________________

Special Values

Библиотека date_time использует пять специальных значений. Они:

По умолчанию набор строк, используемых для представления этих типов: «не-дата-время», «-бесконечность», «+бесконечность», «минимум-дата-время», «максимум-дата-время». При выходе min_date-time и max_date_time отображаются как обычные представления даты/времени: «1400-Jan-01» и «9999-Dec-31» соответственно.

Customization

Парсер/форматтер специальных значений позволяет пользователю устанавливать пользовательские строки для этих специальных значений. Эти строки могут быть установлены в качестве параметров конструкции для нового аспекта или могут быть установлены в существующем аспекте через функцию доступа.

Special Values Formatter/Parser Reference

Special Values Formatter Constructor

special_values_formatter()

special_values_formatter(...)
  Parameters:
    collection_type::iterator
    collection_type::iterator

special_values_formatter(...)
  Parameters:
    char_type*
    char_type*

Special Values Formatter Accessors

OutItrT put_special(...)
  Parameters:
    OutItrT next
    special_values value

date d1(not_a_date_time); date d2(minimum_date_time); special_values_formatter formatter; formatter.put_special(itr, d1); // Puts: "not-a-date-time" formatter.put_special(itr, d2); // Puts: "1400-Jan-01"

Special Values Parser Constructor

special_values_parser()

special_values_parser(...)
  Parameters:
    collection_type::iterator
    collection_type::iterator

special_values_parser(...)
  Parameter:
    scpecial_values_parser

special_values_parser(...)
  Parameters:
    string_type nadt_str
    string_type neg_inf_str
    string_type pos_inf_str
    string_type min_dt_str
    string_type max_dt_str

Special Values Parser Accessors

void sv_strings(...)
  Parameters:
    string_type nadt_str
    string_type neg_inf_str
    string_type pos_inf_str
    string_type min_dt_str
    string_type max_dt_str

bool match(...)
  Parameters:
    stream_itr_type beg
    stream_itr_type end
    match_results

// stream holds "maximum_date_time" typedef special_values_parser svp; svp parser; svp::match_results mr; if(parser.match(itr, str_end, mr)) {d = date(static_cast( mr.match_results)) } else { // error, failed parse } // d == "9999-Dec-31"

________________________________________

Format Date Parser

Парсер даты формата — объект, удерживающий строки на месяцы и названия будней, а также их сокращения. Настраиваемые наборы строк могут быть установлены во время строительства, или строки в существующем формате_date_parser могут быть заменены через функции доступа. И конструктор, и функции доступа принимают вектор строк в качестве аргументов.

Format Date Parser Reference

Format Date Parser Constructor

format_date_parser(...)
                Parameters:
                string_type format
                std::locale

format_date_parser(...)
  Parameters:
    string_type format
    input_collection_type
    input_collection_type
    input_collection_type
    input_collection_type

format_date_parser(...)
  Parameters:
    format_date_parser

Format Date Parser Accessors

string_type format()

void format(string_type)

void short_month_names(...)
  Parameter:
    input_collection_type names

void long_month_names(...)
  Parameter:
    input_collection_type names

void short_weekday_names(...)
  Parameter:
    input_collection_type names

void long_weekday_names(...)
  Parameter:
    input_collection_type names

date_type parse_date(...)
  Parameters:
    string_type input
    string_type format 
    special_values_parser

string inp("2005-Apr-15"); string format("%Y-%b-%d"); date d; d = parser.parse_date(inp, format, svp); // d == 2005-Apr-15

date_type parse_date(...)
  Parameters:
    istreambuf_iterator input
    istreambuf_iterator str_end
    special_values_parser

date_type parse_date(...)
  Parameters:
    istreambuf_iterator input
    istreambuf_iterator str_end
    string_type format
    special_values_parser

// поток держит формат строки «2005-04-15» («%Y-%m-%d»); дата d; d = parser.parse_date (itr, str_end, format, svp); // d == 2005-Apr-15

month_type parse_month(...)
  Parameters:
    istreambuf_iterator input
    istreambuf_iterator str_end
    string_type format

// поток удерживает формат строки «Март»(«%B»); greg_month m; m = parser.parse_month(itr, str_end, format); // m == March

day_type parse_day_of_month(...)
  Parameters:
    istreambuf_iterator input
    istreambuf_iterator str_end

// поток удерживает "01" greg_day d; d = parser.parse_day_of_month (itr, str_end); // d == 1st

day_type parse_var_day_of_month(...)
  Parameters:
    istreambuf_iterator input
    istreambuf_iterator str_end

// поток удерживает "1" greg_day d; d = parser.parse_var_day_of_month (itr, str_end); // d == 1st

day_of_week_type parse_weekday(...)
  Parameters:
    istreambuf_iterator input
    istreambuf_iterator str_end
    string_type format

// stream holds "Tue" string format("%a"); greg_weekday wd; wd = parser.parse_weekday(itr, str_end, format); // wd == Tuesday

year_type parse_year(...)
  Parameters:
    istreambuf_iterator input
    istreambuf_iterator str_end
    string_type format

// поток имеет формат строки «98»(«%y»); greg_year y; y = parser.parse_year (itr, str_end, format); // y == 1998

Date Time IO Tutorial

Basic Use

Аспекты автоматически пропитываются, когда называются операторы «>>» и «<<». Список объектов date_time, которые можно транслировать:

Gregorian

date, days, date_period, greg_month, greg_weekday, greg_year, partial_date, nth_day_of_the_week_in_month, first_day_of_the_week_in_month, last_day_of_the_week_in_month, first_day_of_the_week_after, first_day_of_the_week_before

Posix_time

ptime, time_period, time_duration

Local_time

local_date_time

Следующим примером является базовое использование нового кода ввода-вывода, использующего все по умолчанию. (Этот пример можно найти вlibs/date_time/examples/tutorial)Каталог

    
  date d(2004, Feb, 29);
  time_duration td(12,34,56,789);
  stringstream ss;
  ss << d << ' ' << td;
  ptime pt(not_a_date_time);
  cout << pt << endl; // "not-a-date-time"
  ss >> pt;
  cout << pt << endl; // "2004-Feb-29 12:34:56.000789"
  ss.str("");
  ss << pt << " EDT-05EDT,M4.1.0,M10.5.0";
  local_date_time ldt(not_a_date_time);
  ss >> ldt;
  cout << ldt << endl; // "2004-Feb-29 12:34:56.000789 EDT"
    
  

В этом примере использовались настройки по умолчанию для граней ввода и вывода. Форматы по умолчанию таковы, что возможна интероперабельность, как показано в примере. ПРИМЕЧАНИЕ: Вводная потоковая передача локального_date_time может быть выполнена только с помощью строкипозикса часового пояса. Формат вывода по умолчанию использует аббревиатуру часового пояса. Формат может быть изменен таким образом и в соответствии (как мы увидим позже в этом руководстве).

Format Strings

Строки формата контролируют порядок, тип и стиль используемых элементов даты/времени. Формы предоставляют некоторые предопределенные форматы (iso_format_specifier, iso_format_extended_specifier и default_date_format), но пользователь может легко создать свой собственный.

    
  local_time_facet* output_facet = new local_time_facet();
  local_time_input_facet* input_facet = new local_time_input_facet();
  ss.imbue(locale(locale::classic(), output_facet));
  ss.imbue(locale(ss.getloc(), input_facet));
  
  output_facet->format("%a %b %d, %H:%M %z");
  ss.str("");
  ss << ldt;
  cout << ss.str() << endl; // "Sun Feb 29, 12:34 EDT"
  output_facet->format(local_time_facet::iso_time_format_specifier);
  ss.str("");
  ss << ldt;
  cout << ss.str() << endl; // "20040229T123456.000789-0500"
 
  output_facet->format(local_time_facet::iso_time_format_extended_specifier);
  ss.str("");
  ss << ldt;
  cout << ss.str() << endl; // "2004-02-29 12:34:56.000789-05:00"
    
  

Строки формата не ограничены элементами даты/времени. Дополнительное слово может быть помещено в строку формата. ПРИМЕЧАНИЕ: Когда дополнительное словосочетание присутствует в формате ввода, вводимые данные также должны содержать точное словосочетание.

    
  // extra words in format
  string my_format("The extended ordinal time %Y-%jT%H:%M can also be \
  represented as %A %B %d, %Y");
  output_facet->format(my_format.c_str());
  input_facet->format(my_format.c_str());
  ss.str("");
  ss << ldt;
  cout << ss.str() << endl;
  // matching extra words in input 
  ss.str("The extended ordinal time 2005-128T12:15 can also be \
  represented as Sunday May 08, 2005");
  ss >> ldt;
  cout << ldt << endl;
    
  

Content Strings

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

Значения по умолчанию для них следующие:

Special values

not-a-date-time, -infinity, +infinity, minimum-date-time, maximum-date-time

Months

Английский календарь и три буквенные сокращения

Weekdays

Английский календарь и три буквенные сокращения

Date generator phrase elements

first, second, third, fourth, fifth, last, before, after, of

ПРИМЕЧАНИЕ: Ранее мы показали, что компоненты представления даты/времени могут быть переупорядочены через строку формата. Это не относится к генераторам дат. Сами элементы могут быть настроены, но их порядок не может быть изменен.

Content Strings

Чтобы проиллюстрировать возможности настройки, мы будем использовать пользовательские строки в течение месяцев и будни (мы будем использовать только длинные имена, для этого примера).

    
  // set up the collections of custom strings.
  // only the full names are altered for the sake of brevity
  string month_names[12] = { "january", "february", "march", 
                             "april", "may", "june", 
                             "july", "august", "september", 
                             "october", "november", "december" };
  vector<string> long_months(&month_names[0], &month_names[12]);
  string day_names[7] = { "sunday", "monday", "tuesday", "wednesday", 
                          "thursday", "friday", "saturday" };
  vector<string> long_days(&day_names[0], &day_names[7]);
  
  //  create date_facet and date_input_facet using all defaults
  date_facet* date_output = new date_facet();
  date_input_facet* date_input = new date_input_facet();
  ss.imbue(locale(ss.getloc(), date_output)); 
  ss.imbue(locale(ss.getloc(), date_input));
  // replace names in the output facet
  date_output->long_month_names(long_months);
  date_output->long_weekday_names(long_days);
  
  // replace names in the input facet
  date_input->long_month_names(long_months);
  date_input->long_weekday_names(long_days);
  
  // customize month, weekday and date formats
  date_output->format("%Y-%B-%d");
  date_input->format("%Y-%B-%d");
  date_output->month_format("%B"); // full name
  date_input->month_format("%B"); // full name
  date_output->weekday_format("%A"); // full name
  date_input->weekday_format("%A"); // full name
  ss.str("");
  ss << greg_month(3);
  cout << ss.str() << endl; // "march"
  ss.str("");
  ss << greg_weekday(3);
  cout << ss.str() << endl; // "tuesday"
  ss.str("");
  ss << date(2005,Jul,4);
  cout << ss.str() << endl; // "2005-july-04"
    
  

Special Values

Настройка ввода и вывода специальных значений лучше всего осуществляется путем создания нового специального_значения_парсера и специального_значения_форматтера. Новые струны могут быть установлены во время строительства (как в примере ниже).

    
  // reset the formats to defaults
  output_facet->format(local_time_facet::default_time_format);
  input_facet->format(local_time_input_facet::default_time_input_format);
  // create custom special_values parser and formatter objects
  // and add them to the facets
  string sv[5] = {"nadt","neg_inf", "pos_inf", "min_dt", "max_dt" };
  vector<string> sv_names(&sv[0], &sv[5]);
  special_values_parser sv_parser(sv_names.begin(), sv_names.end());
  special_values_formatter sv_formatter(sv_names.begin(), sv_names.end());
  output_facet->special_values_formatter(sv_formatter);
  input_facet->special_values_parser(sv_parser);
  ss.str("");
  ldt = local_date_time(not_a_date_time);
  ss << ldt;
  cout << ss.str() << endl; // "nadt"
  
  ss.str("min_dt");
  ss >> ldt;
  ss.str("");
  ss << ldt;
  cout << ss.str() << endl; // "1400-Jan-01 00:00:00 UTC"
    
  

ПРИМЕЧАНИЕ: несмотря на то, что мы отправили строки для min и max в форматировщик, они игнорируются, потому что эти специальные значения строятся на фактические даты (как показано выше).

Date/Time Periods

Настройка ввода и вывода периодов лучше всего осуществляется путем создания нового парсера периодов и формата периодов. Новые струны могут быть установлены во время строительства (как в примере ниже).

    
  // all formats set back to defaults (not shown for brevity)
  // create our date_period
  date_period dp(date(2005,Mar,1), days(31)); // month of march
  // custom period formatter and parser
  period_formatter per_formatter(period_formatter::AS_OPEN_RANGE, 
                                 " to ", "from ", " exclusive", " inclusive" );
  period_parser per_parser(period_parser::AS_OPEN_RANGE, 
                           " to ", "from ", " exclusive" , "inclusive" );
  
  // default output
  ss.str("");
  ss << dp;
  cout << ss.str() << endl; // "[2005-Mar-01/2005-Mar-31]"
 
  // add out custom parser and formatter to  the facets
  date_output->period_formatter(per_formatter);
  date_input->period_parser(per_parser);
  
  // custom output
  ss.str("");
  ss << dp;
  cout << ss.str() << endl; // "from 2005-Feb-01 to 2005-Apr-01 exclusive"
    
  

Date Generators

Настройка ввода и вывода генераторов дат производится путем замены существующих строк (в аспекте) новыми строками.

ПРИМЕЧАНИЕ: Ранее мы показали, что компоненты представления даты/времени могут быть переупорядочены через строку формата. Это не относится к генераторам дат. Сами элементы могут быть настроены, но их порядок не может быть изменен.

    
  // custom date_generator phrases
  string dg_phrases[9] = { "1st", "2nd", "3rd", "4th", "5th", 
                           "final", "prior to", "following", "in" };
  vector<string> phrases(&dg_phrases[0], &dg_phrases[9]);
  // create our date_generator
  first_day_of_the_week_before d_gen(Monday);
  // default output
  ss.str("");
  ss << d_gen;
  cout << ss.str() << endl; // "Mon before"
 
  // add our custom strings to the date facets
  date_output->date_gen_phrase_strings(phrases);
  date_input->date_gen_element_strings(phrases);
  
  // custom output
  ss.str("");
  ss << d_gen;
  cout << ss.str() << endl; // "Mon prior to"