На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

Time and Date



You can retrieve strings for any given time or date in a format that is appropriate for the current locale by using the GetTimeFormat and GetDateFormat functions.

For GetTimeFormat, the time values in the SYSTEMTIME structure pointed to by lpTime must be valid. The function checks each of the time values to determine that it is within the appropriate range of values. If any of the time values are outside the correct range, the function fails, and sets the last-error to ERROR_INVALID_PARAMETER.
The function ignores the date portions of the SYSTEMTIME structure pointed to by lpTime: wYear, wMonth, wDayOfWeek, and wDay.

If a time marker exists and the TIME_NOTIMEMARKER flag is not set, the function localizes the time marker based on the specified locale identifier. Examples of time markers are "AM" and "PM" for US English, "de." and "du." for Mexican Spanish.
If TIME_NOMINUTESORSECONDS or TIME_NOSECONDS is specified, the function removes the separator(s) preceding the minutes and/or seconds element(s).
If TIME_NOTIMEMARKER is specified, the function removes the separator(s) preceding and following the time marker.

If TIME_FORCE24HOURFORMAT is specified, the function displays any existing time marker, unless the TIME_NOTIMEMARKER flag is also set.
The function does not include milliseconds as part of the formatted time string.
To use the LOCALE_NOUSEROVERRIDE flag, lpFormat must be NULL.
No errors are returned for a bad format string. The function simply forms the best time string that it can. If more than two hour, minute, second, or time marker format pictures are passed in, then the function defaults to two. For example, the only time marker pictures that are valid are L"t" and L"tt" (the 'L' indicates a Unicode (16-bit characters) string). If L"ttt" is passed in, the function assumes L"tt".

For GetDateFormat, the date values in the SYSTEMTIME structure pointed to by lpDate must be valid. The function checks each of the date values: year, month, day, and day of week. If the day of the week is incorrect, the function uses the correct value, and returns no error. If any of the other date values are outside the correct range, the function fails, and sets the last-error to ERROR_INVALID_PARAMETER.
The day name, abbreviated day name, month name, and abbreviated month name are all localized based on the given locale identifier. The function ignores the time portions of the SYSTEMTIME structure pointed to by lpDate: wHour, wMinute, wSecond, and wMilliseconds.

The flag DATE_USE_ALT_CALENDAR will always use the format defined as the default format for that alternate calendar, rather than using any user overrides. The user overrides will only be used in the event that there is no default format for the alternate calendar specified.
The DATE_SHORTDATE and DATE_LONGDATE flag options are mutually exclusive. If neither one is specified and lpFormat is NULL, then DATE_SHORTDATE is the default.
If the lpFormat parameter is not NULL, the dwFlags parameter must be zero. None of the flags make sense when the format string is specified.

No errors are returned for a bad format string. The function simply forms the best date string that it can. For example, the only year pictures that are valid are L"yyyy" and L"yy" (the 'L' indicates a Unicode (16-bit characters) string). If L"y" is passed in, the function assumes L"yy". If L"yyy" is passed in, the function assumes L"yyyy". If more than 4 date (L"dddd") or 4 month (L"MMMM") pictures are passed in, then the function defaults to L"dddd" or L"MMMM".
Any text that should remain in its exact form in the date string should be enclosed within single quotes in the date format picture. The single quote may also be used as an escape character to allow the single quote itself to be displayed in the date string. However, the escape sequence must be enclosed within two single quotes. For example, to display the date as "May '93", the format string would be: L"MMMM ''''yy " The first and last single quotes are the enclosing quotes. The second and third single quotes are the escape sequence to allow the single quote to be displayed before the century.


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

Время и Дата



Вы можете извлечь строки в течение любого данного времени или датироваться в формат, который подходящий для текущего места действия используя GetTimeFormat и функции GetDateFormat.

Для GetTimeFormat, время оценивается в структуре SYSTEMTIME указанной, чтобы lpTime должно быть в силе. Функция проверяется всякий раз, когда величины, чтобы определять, что это - в пределах подходящего дипазона величин. Если любая из величин времени - за пределами правильного дипазона, функция терпит неудачу, и устанавливает последнюю-ошибку на ERROR_INVALID_PARAMETER.
Функция игнорирует дату частей структуры SYSTEMTIME указанной, чтобы lpTime: wYear, wMonth, wDayOfWeek, и wDay.

Если маркер времени существует и флаг TIME_NOTIMEMARKER не установлен, функция локализует маркер времени основанный на определенном месте действия идентификатора. Примеры маркеров времени - "-" и "ПОСЛЕ ПОЛУДНЯ" для Английского US, "de." и "du." для Мексиканского Испанский.
Если TIME_NOMINUTESORSECONDS или TIME_NOSECONDS определен, функция удаляет разделитель(разделители) предшествуя протоколу и/или элементу секунд(секунд).
Если TIME_NOTIMEMARKER определен, функция удаляет разделитель(разделители) предшествуя и следуя за маркером времени.

Если TIME_FORCE24HOURFORMAT определен, функция отображает любой существующий маркер времени, если флаг TIME_NOTIMEMARKER не - также устанавливаться.
Функция не включает миллисекунды как часть форматированной строки времени.
Для того, чтобы использовать флаг LOCALE_NOUSEROVERRIDE, lpFormat должен быть НЕДЕЙСТВИТЕЛЕН.
Никакие ошибки не возвращаны для плохой строки формата. Функция просто формирует наилучшую строку времени, которая она может. Если более, чем два часа, минуты, секунды, или изображений формата маркера времени пройдены в, тогда функция устанавливается по умолчанию на два. Например, единственный маркер времени изображает, что быть в силе - L"t" и L"tt" ( 'L указывает Уникод (16- битовые символы) строка). Если L"ttt" пройден в, функция принимает L"tt".

Для GetDateFormat, дата оценивается в структуре SYSTEMTIME указанной, чтобы lpDate должно быть в силе. Функция проверяет каждую дату величин: год, месяц, день, и день недели. Если день недели неправильный, функция использует правильную величину и не возвращает никакую ошибку. Если любая из другой даты величин - за пределами правильного дипазона, функция терпит неудачу, и устанавливает последнюю-ошибку на ERROR_INVALID_PARAMETER.
Дневное имя, укорачивало дневное имя, месячное имя, и укоротившие месячное имя полностью локализованы основанное на данном месте действия идентификатора. Функция игнорирует части времени структуры SYSTEMTIME указанной, чтобы lpDate: wHour, wMinute, wSecond, и wMilliseconds.

Флаг DATE_USE_ALT_CALENDAR всегда использует формат определенный как по умолчанию формат для этого альтернативного календаря, а не используя любого пользователя аннулируется. Пользователь аннулирует, только будет использован в случае, если нет по умолчанию формата для альтернативного календаря определенного.
DATE_SHORTDATE И опции флага DATE_LONGDATE взаимно исключительные. Если никакое один определен и lpFormat НЕДЕЙСТВИТЕЛЕН, тогда DATE_SHORTDATE по умолчанию.
Если параметр lpFormat не НЕДЕЙСТВИТЕЛЕН, параметр dwFlags должен - нулевым. Ни один из флагов не имеют смысл когда строка формата определена.

Никакие ошибки не возвращаны для плохой строки формата. Функция просто формирует наилучшую строку даты, которая она может. Например, единственный год изображает, что быть в силе - L"yyyy" и L"yy" ( 'L указывает Уникод (16- битовые символы) строка). Если L"y" пройден в, функция принимает L"yy". Если L"yyy" пройден в, функция принимает L"yyyy". Если более, чем 4 даты изображений (L"dddd") или 4 месяца (L"MMMM") пройдены в, тогда функция устанавливается по умолчанию на L"dddd" или L"MMMM".
Любой текст, который должен оставаться в своей точной форме на дате строки должно быть приложено в пределах единственных цитат на дате изображения формата. Единственная кавычка может также использована как символ перехода, чтобы позволять единственную кавычку, чтобы быть отображенн на дате строки. Тем не менее, последовательность перехода должна быть приложена в пределах двух единственных кавычек. Например, чтобы отображать дату как "Может '93", строка формата должна быть: L"MMMM ''''yy " первые и последние единственные цитаты являются объемлющими кавычками. Вторые и третьи единственные цитаты являются последовательностью перехода, чтобы допускать единственную кавычку, которая нужно отображаться перед столетием.


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz