StrToDateTime - Функция. Справочник

Delphi справочник - Форум программистов - Навигация

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 По первой букве

System SysUtils StrUtils DateUtils FileCtrl ConvUtils StdConvs Math Classes Dialogs Types Variants ПО Unit Compiler directives Directives Keywords Types Variables Constants Functions Procedures По категории

Основы Delphi
StrToDateTime Функция	Конвертирует строку с датой и временем в значение типа TDateTime	SysUtils unit

1 function StrToDateTime ( const DateTime : string ) : TDateTime;

2 function StrToDateTime ( const DateTime : string; const FormatSettings : TFormatSettings ) : TDateTime;

Описание

Функция StrToDateTime предназначена для преобразования строки DateTime в значение типа TDateTime.

Во-первых, часть строки с датой должна соответствовать формату, заданному в переменной ShortDateFormat, и использовать символ DateSeparator (точка - разделитель) для разделения значений дня, месяца и года.

Во-вторых, часть с временем, отделенная пробелом от даты должна соответствовать формату, заданному в переменной LongTimeFormat и использовать символ TimeSeparator (точка - разделитель для разделения значений часа, минуты и секунды.

Форматом по умолчанию для Англии является день/месяц/год час:минута:секунда.мсек, где:

день должен быть в диапазоне 1..31 (зависит от месяца/года)
месяц должен быть в диапазоне 1..12
год должен быть в диапазоне 0..9999 (необязательный параметр)
час должен быть в диапазоне 0..23
минута должна быть в диапазоне 0..59 (необязательный параметр)
секунда должна быть в диапазоне 0..59 (необязательный параметр)
миллисекунда должна быть в диапазоне 0..999 (необязательный параметр)

Если год не вводиться, то функция использует текущий год.

Обратите внимание, что, к примеру, 0015-й год должен быть задан вместе с цифрами века; 15-й год будет расценен как относящийся к текущему веку.

Если год двузначный, то век определяется значением переменной TwoDigitYearCenturyWindow.

Если время установлено в 0, то это указывает на начало заданного дня.

Любые ошибки в строке с датой вызовут исключение EConvertError.

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

Похожие команды

DateSeparator  Символ используемый для разделения полей отображаемой даты

DateTimeToStr  Конвертирует значение даты и времени TDateTime в строку

LongTimeFormat  Длинная версия времени в строковом формате

ShortDateFormat  Компактная версия даты в строковом формате

StrToDate  Конвертирует строку с датой в значение типа TDateTime

StrToTime  Конвертирует строку с временем в значение с типом TDateTime

TimeAMString  Определяет значение AM в процедуре DateTimeToString

TimePMString  Определяет значение PM в процедуре DateTimeToString

TimeSeparator  Символ, используемый для разделения полей времени

Пример кода : Показ строковых преобразовний года с 2-мя и 4-мя цифрами

var
  myDateTime : TDateTime;

begin
  myDateTime := StrToDateTime('23/02/75   12');
  ShowMessage('23/02/75   12      = '+DateTimeToStr(myDateTime));

  myDateTime := StrToDateTime('23/02/2075 12:34:56');
  ShowMessage('23/02/2075 12:34:56 = '+DateTimeToStr(myDateTime));
end;

23/02/75 12 = 23/02/1975 12:00:00
23/02/2075 12:34:56 = 23/02/2075 12:34:56

Оплата за обучение в Kata Academy только после твоего трудоустройства в IT, начни карьеру Middle Java-разработчика

Интенсив по Python: Работа с API и фреймворками 24-26 ИЮНЯ 2022. Знаете Python, но хотите расширить свои навыки? Slurm подготовили для вас особенный продукт!