6.4.5. Преобразования дат и времени

Функции объявлены в файлах SysUtils.hpp,time.h.

System::TDateTime Date(void) ‑ возвращает текущую дату.

System::AnsiString DateTimeToStr(System::TDateTime DateTime) - преоб­ра­зует DateTime в строку.

Void DateTimeToString(System::AnsiString &Result, const System:: Ansi­String Format, System::TDateTime Date Time) ‑ преобразует DateTime в строку Result по формату Format (п.1.7.3).

System::AnsiString DateToStr(System::TDateTime Date) ‑ преобразует дату Date в строку.

void DateTimeToSystemTime(System::TDateTime DateTime, _SYSTEM­TI­ME &SystemTime) ‑ преобразует DateTime в формат TSystemTime, исполь­зу­емый в API Windows.

int DayOfWeek(System::TDateTime Date) ‑ извлекает из датыDateдень недели (от 1 до 7, 1 - воскресенье).

void DecodeTime(System::TdateTime Time, Word &Hour, Word &Min, Word &Sec, Word &Msec) ‑ разбивает Time на часы Hour, минуты Min, секунды Sec, миллисекунды Msec.

TDateTime EncodeDate(Word Year, Word Month, Word Day) ‑ преобразует год Year, месяц Month и день Day в TdateTime.

TDateTime EncodeDate(Word Hour, Word Min, Word Sec, Word MSec) ‑ пре­образует часы Hour, минуты Min, секунды Sec, миллисекунды MSec в TDateTime.

System::AnsiString FormatDateTime(const System:: AnsiString Format,System::TDateTime DateTime) ‑ преобразует DateTime в строку по формату Format.

System::TDateTime IncMonth(const System:: TdateTime Date, int NumberOfMonths) ‑ возвращает дату Date, измененную на NumberOfMonths месяцев.

bool IsLeapYear(Word Year) ‑ возвращает true, если год Year високосный.

System::TDateTime Now(void) ‑ возвращает текущую дату и время.

System::TDateTime StrToDate(const System::AnsiString S) ‑ преобразует строку S в дату TDateTime.

System::TDdateTime StrToDateTime(const System::AnsiString S) - пре­об­ра­зу­ет строку S в дату и время TDateTime.

System::TDdateTime StrToTime(const System::AnsiString S) ‑ преобразует строку S во время TDateTime.

System::TDateTime SystemTimeToDateTime(const _SYSTEMTIME &SystemTime) ‑ преобразует формат TSystemTime, используемый в API Windows, в TdateTime.

System::TDateTime(void) ‑ возвращает текущее время.

System::AnsiString TimeToStr(System::TDateTime Time) ‑ преобразует время в строку.

6.4.6. Методы обработки строк типа AnsiString

int _fastcall AnsiCompare/AnsiCompareIC(const AnsiString& rhs) const ‑ сравнивает данную строку S1 с rhs с учетом/без учета регистра и текущих установок Windows. Возвращает значение: >0 приS1>rhs, <0 приS1<rhsи 0 приS1=rhs.

сhar* _fastcall AnsiLastChar() const ‑ возвращает указатель на последний значащий символ.

int _fastcall AnsiPos(const AnsiString& subStr) const ‑ возвращает индекс первого вхождения subStr в S1. ЕслиsubStr не содержится в S1, возвращается 0.

void _fastcall Delete(int index, int count) ‑ удаляет из строки, начиная с позицииindex, число символов, равноеcount.

void _fastcall Insert(const AnsiString& str, int index) ‑ вставляет в строку подстроку str, начиная с индекса index.

bool _fastcall IsDelimiter(const AnsiString& Delimiters, int index) const - воз­вращает true, если символ с индексом index является одним из разделителей, указанных в строке Delimiters.

bool _fastcall IsEmply()const ‑ возвращает true, если строка пустая.

Int _fastcall LastDelimiter(const AnsiString& Delimiters) const ‑ возвращает последний из символов строки, входящих в строку разделителей Delimiters.

int _fastcall Length() const ‑ возвращает число символов в строке.

AnsiString _ fastcall LowerCase/UpperCase() const ‑ возвращает строку, в которой все символы приведены к нижнему/верхнему регистру.

void _fastcall SetLength(int newLength) ‑ усекает строку до newLength символов. Если исходная строка короче, то она не увеличивается.

staticAnsiString _ fastcall StringOfChar(char ch, int count) ‑ возвращает строку, в которой символch повторен count раз.

AnsiString _ fastcall SubString(int index, int count) const ‑ возвращает подстроку, начинающуюся с символа в позицииindex и содержащуюcount символов.

double _ fastcall ToDouble/ToInt() const ‑ преобразует строку в вещест­вен­ное/целое число.

int_fastcall ToIntDef(int default Value) const ‑ преобразует строку в целое число. Если строка не соответствует формату целого числа, возвращается значение по умолчаниюdefault Value.

AnsiString _ fastcall Trim() const ‑ возвращает строку, соответствующую исходной, но без пробельных символов до и после значащих символов.

AnsiString _ fastcall TrimLeft/TrimRight() const ‑ возвращает строку, соот­вет­ст­ву­ющую исходной, но без начальных/заключительных пробельных символов.

wchar_t* _ fastcall WideChar(wchar_t* dest, int destSize) const ‑ преобразует строку в массив символовdest типа wchar_t.