Споделяне чрез


Функции по време на изпълнение на X++ конвертиране

Бележка

Групите по интереси на общността вече са преместени от Yammer към Microsoft Viva Engage. За да се присъедините към общност Viva Engage и да участвате в последните обсъждания, попълнете формуляра Искане за достъп до финанси и операции Viva Engage Community и изберете общността, към която искате да се присъедините.

В тази статия са описани функциите по време на изпълнение на конвертирането.

any2Date

Преобразува стойност на anytype в стойност на дата .

date any2Date(anytype object)

Параметри

параметър Описание
обект Стойността, която трябва да се преобразува в дата.

Стойност на връщане

Стойност на дата .

Забележки

Параметърът на обекта може да бъде от повечето типове данни, но се получава полезен резултат, когато е от типа str или int . Неподходящото съдържание генерира грешка по време на изпълнение.

Пример

static void any2DateExample(Args _args)
{
    date myDate;
    str s;
    int i;
    s = "2010 6 17"; // A string object, of yyyy mm dd.
    myDate = any2Date(s);
    Global::info(strFmt("%1  is output, from input of "2010 6 17"", myDate));
    i = 40361; // An int object, which represents the number of days from 1900/01/01.
    myDate = any2Date(i);
    Global::info(strFmt("%1  is output, from input of 40361", myDate));
}
/**** Infolog display.
Message (04:44:15 pm)
6/17/2010 is output, from input of "2010 6 17"
7/4/2010 is output, from input of 40361
****/

any2Enum

Преобразува стойност на anytype в стойността на свойството Name на елемент в целевата номериране.

enum any2Enum(anytype object)

Параметри

параметър Описание
обект Стойността, която трябва да съвпада със свойството Стойност на елемент в целевата номериране.

Стойност на връщане

Стойността на свойството Name за елемента в целевата номериране има свойство Value , което съответства на входния параметър.

Забележки

Параметърът на обекта може да бъде от повечето типове данни, но полезни данни се получават само когато използвате параметър от типа str или int . Този параметър на входния обект препраща към свойството Value на отделен елемент в целевата номериране.

Пример

static void any2EnumExample(Args _args)
{
    NoYes myNoYes;  // NoYes is an enum.
    int i;
    str s;
    i = 0;  // An int that will be converted.
    myNoYes = any2Enum(i);
    Global::info(strfmt("'%1' - is the output, from input of the %2 as int.", myNoYes, i));
    s = "1";  // A str that will be converted.
    myNoYes = any2Enum(s);
    Global::info(strfmt("'%1' - is the output, from input of the %2 as str.", myNoYes, s));
    /**** Infolog display.
    Message (01:05:32 pm)
    'No' - is the output, from input of the 0 as int.
    'Yes' - is the output, from input of the 1 as str.
    ****/
}

any2Guid

Преобразува зададения anytype обект в GUID обект.

guid any2Guid(anytype object)

Параметри

параметър Описание
обект Стойността, която трябва да се преобразува в GUID обект.

Стойност на връщане

GUID обект.

any2Int

Преобразува стойност на anytypeв int стойност.

int any2Int(anytype object)

Параметри

параметър Описание
обект Стойността, която трябва да се преобразува.

Стойност на връщане

Int стойност.

Забележки

Параметърът на обекта може да бъде от повечето типове данни, но полезните данни се получават само когато използвате параметри от тип enum, real или str .

Пример

static void any2IntExample(Args _args)
{
    int myInt;
    str s;
    NoYes a;
    real r;
    s = "31";
    myInt = any2Int(s);
    Global::info(strfmt("%1 is the output, from input of 31 as a str value.", myInt));
    a = NoYes::No;
    myInt = any2Int(a);
    Global::info(strfmt("%1 is the output, from input of NoYes::No as an enum value.", myInt));
    r = 5.34e2;
    myInt = any2Int(r);
    Global::info(strfmt("%1 is the output, from the input of 5.34e2 as a real value.", myInt));
}
/**** Infolog display.
Message (02:23:59 pm)
31 is the output, from input of 31 as a str value.
0 is the output, from input of NoYes::No as an enum value.
534 is the output, from the input of 5.34e2 as a real value.
****/

any2Int64

Преобразува всеки тип обект в int64 обект.

int64 any2Int64(anytype object)

Параметри

параметър Описание
обект Anytype обект за конвертиране.

Стойност на връщане

Int64 обект.

всеки2real

Преобразува стойност на anytype в реална стойност.

real any2Real(anytype object)

Параметри

параметър Описание
обект Стойността, която трябва да се преобразува.

Стойност на връщане

Истинска стойност.

Забележки

Параметърът на обекта може да бъде от повечето типове данни, но се получава полезен резултат за входни елементи от типовете дата, цяло, номериране и щ.н .

Пример

static void any2RealExample(Args _args)
{
    real myReal;
    str s;
    int i;
    NoYes a;
    s = "5.12";
    myReal = any2Real(s);
    Global::info(strfmt("%1 is the output from the input of 5.12 as a str object", myReal));
    i = 64;
    myReal = any2Real(i);
    Global::info(strfmt("%1 is the output from the input of 64 as an int object", myReal));
    a = NoYes::Yes;
    myReal = any2Real(a);
    Global::info(strfmt("%1 is the output from the input of NoYes::Yes as an enum object", myReal));
}
/****Infolog display.
Message (02:43:57 pm)
5.12 is the output from the input of 5.12 as a str object
64.00 is the output from the input of 64 as an int object
1.00 is the output from the input of NoYes::Yes as an enum object
****/

any2Str

Преобразува стойност на anytype в стойност str .

str any2Str(anytype object)

Параметри

параметър Описание
обект Стойността, която трябва да се преобразува.

Стойност на връщане

Стойност на str .

Забележки

Параметърът на обекта може да бъде от повечето типове данни, но полезният резултат се получава от входни елементи от типовете дата, цяло и номериране .

Пример

static void any2StrExample(Args _args)
{
    str myStr;
    anytype a;
    a = "Any to string";
    myStr = any2Str(a);
    Global::info(strFmt("%1 is output, from input of Any to string as a str value", myStr));
    a = NoYes::Yes;
    myStr = any2Str(a);
    Global::info(strFmt("%1 is output, from input of NoYes::Yes as an enumeration", myStr));
}
/****Infolog Display
Message (09:08:46 am)
Any to string is output, from input of Any to string as a str value
1 is output, from input of NoYes::Yes as an enumeration
****/

anytodate

Вижте any2Date.

anytoenum

Вижте any2Enum.

anytoguid

Вижте any2Guid.

произволен оттенък

Вижте any2Int.

anytoint64

Вижте any2Int64.

при всяко хранилище

Вижте any2Real.

anytostr

Вижте any2Str.

char2Num

Преобразува знак в низ в ASCII стойността на знака.

int char2Num(str text, int position)

Параметри

параметър Описание
SMS Низът, съдържащ знака.
положение Позицията на знака в низа.

Стойност на връщане

ASCII стойността на знака като int обект.

Забележки

char2Num("ABCDEFG",3); //Returns the numeric value of C, which is 67.
char2Num("ABCDEFG",1); //Returns the numeric value of A, which is 65.

date2Num

Преобразува дата в цяло число, което съответства на броя на дните от 1 януари 1900 г.

int date2Num(date _date)

Параметри

параметър Описание
_дата Датата, която трябва да се преобразува.

Стойност на връщане

Броят на дните между 1 януари 1900 г. и указаната дата.

Пример

//Returns the value377.
date2Num(1311901);
static void date2NumExample(Args _arg)
{
    date d = today();
    int i;
    i = date2Num(d);
    print i;
}

дата2Str

Преобразува указаната дата в низ.

str date2Str(date date, int sequence, int day, int separator1, int month, int separator2, int year [, int flags = DateFlags::None])

Параметри

параметър Описание
дата Датата, която трябва да се преобразува.
Последователност Трицифрено число, което показва последователността за компонентите на датата: 1 за деня, 2 за месец и 3 за годината.
ден Стойност на изброяване, която показва формата за компонента за ден на датата.
разделител1 Стойност на изброяване, която показва разделителя, който да се използва между първите два компонента на датата.
месец Стойност на изброяване, която показва формата за компонента месец на датата.
разделител 2 Стойност на изброяване, която показва разделителя, който да се използва между последните два компонента на датата.
година Стойност на изброяване, която показва формата за компонента година на датата.
Знамена DateFlags стойност на изброяване, която показва дали езиковите настройки на локалния компютър трябва да се използват за изчисляване на правилната последователност от ляво надясно или от дясно наляво във върнатия низ.

Стойност на връщане

Низ, представящ указаната дата.

Забележки

MorphX заделя валидни стойности за параметрите за форматиране, ако зададените стойности не са валидни. За да използвате формата за дата, зададен от потребителя в Регионални настройки, използвайте функцията strFmt или date2Str и задайте -1 във всички параметри за форматиране. Когато регионалните настройки управляват формата на датата, настройките могат да се променят от потребител на потребител. Ако -1 се използва за някой от двата параметъра за разделител , и двата разделители по подразбиране са регионални настройки. Стойностите на параметрите на поредицата трябва да бъдат всяко трицифрено число, което съдържа точно едно повторение на всяка цифра 1, 2 и 3. Цифрите 1, 2 и 3 представят съответно ден, месец и година. Например 321 произвежда годината, месеца и деня на поредицата. Или стойността може да бъде -1 , за да използвате регионалните настройки. За този параметър не трябва да се използва тип изброяване, тъй като числа като 321 надвишават диапазона от валидни стойности за стойностите на изброяване, който е от 0 до 250 включително. Стойността по подразбиране на параметъра flags е DateFlags::None стойност на изброяване, което означава, че не се извършва обработка на последователност от ляво надясно или от дясно наляво.

Пример

Следващият пример показва текущата дата в последователността от година, месец и ден.

static void Job2(Args _args)
{
    date currentDate = today();
    str s;
    int iEnum;
    s = date2Str
    (currentDate, 
        321,
        DateDay::Digits2,
        DateSeparator::Hyphen, // separator1
        DateMonth::Digits2,
        DateSeparator::Hyphen, // separator2
        DateYear::Digits4
    );
    info("Today is:  " + s);
}
/** Example Infolog output
Message (12:36:21 pm)
Today is:  2009-01-13
**/

datetime2Str

Преобразува стойност на utcdatetime в низ.

str datetime2Str(utcdatetime datetime [, int flags = DateFlags::None])

Параметри

параметър Описание
datetime Стойността на utcdatetime , която трябва да се преобразува.
Знамена DateFlags стойност на изброяване, която показва дали да се използват локални настройки за изход от дясно наляво.

Стойност на връщане

Низ, който представлява стойността на utcdatetime , зададена като параметър за дата и час .

Забележки

Въвеждане на празна дата и час

Ако е зададена минимална стойност на utcdatetime за параметъра datetime , функцията datetime2Str я третира като празна входна стойност. Това кара функцията да върне празен низ. Дата и час 1900-01-01T00:00:00 се връща от метода DateTimeUtil::minValue . Тази минимална стойност се третира като Null.

Локални настройки "от дясно наляво"

Поведението по подразбиране на тази функция е да генерира низа в последователност "от ляво надясно", където частта за годината е най-вляво. Обаче стойността на параметъра flags на DateFlags::FormatAll изброяване насочва функцията да генерира низа в последователност от дясно наляво, ако локалните настройки са конфигурирани за от дясно наляво. Форматът на метода toStr на класа DateTimeUtil не се влияе от регионалните настройки.

Пример

static void jobTestDatetime2str( Args _args )
{
    utcdatetime utc2 = 1959-06-17T15:44:33;
    str s3;
    s3 = datetime2Str( utc2 );
    info( s3 );
}

Enum2Str

Преобразува указания номериран текст в представяне на знаци.

str enum2Str(enum enum)

Параметри

параметър Описание
изброяване Номерираният текст за конвертиране.

Стойност на връщане

Стойността на изброяването като низ.

Пример

Следващият пример връща низа "Не е включен". Това е етикетът за стойността IncludeNot на типа изброяване ListCode .

static void enum2StrExample(Args _arg)
{
    ListCode l;
    l =  ListCode::IncludeNot;
    print enum2Str(l);
}

Guid2Str

Преобразува указания GUID обект в еквивалентен низ.

str guid2String(guid _uuid)

Параметри

параметър Описание
_uuid GUID обектът за конвертиране.

Стойност на връщане

Еквивалентът на низа на указания GUID обект.

Пример

static void guid2StrExample()
{
    guid _guid;
    str stringGuid;
    _guid = Global::guidFromString("{12345678-1234-1234-1234-123456789abc}");
    print strfmt("GUID is %1", _guid);
    stringGuid = guid2str(_guid);
    info("String GUID is " + stringGuid);
}
/**** Output to Infolog
String GUID is {12345678-1234-1234-1234-123456789ABC}
****/

int2Str

Преобразува цяло число в еквивалентния низ.

str int2Str(int integer)

Параметри

параметър Описание
цяло число Цяло число за конвертиране.

Стойност на връщане

Представяне на низ на цяло число.

Пример

static void int2StrExample(Args _arg)
{
    print "This is int2Str, value is " + int2Str(intMax());
    print "This is int642Str, value is " + int642Str(int64Max());
}

int642Str

Преобразува указания целочислен параметър в еквивалентен текстов низ.

str int642Str(int64 integer)

Параметри

параметър Описание
цяло число Int64 за конвертиране в низ.

Стойност на връщане

Еквивалентният текстов низ на параметъра integer .

Пример

static void example()
{
    print "This is int2Str, value is " + int2Str(intMax());
    print "This is int642Str, value is " + int642Str(int64Max());
}

num2Char

Преобразува цяло число в съответния ASCII знак.

str num2Char(int figure)

Параметри

параметър Описание
фигура Цяло число за преобразуване в знак.

Стойност на връщане

Знакът, който е представен от указаното цяло число.

Пример

static void num2CharExample(Args _arg)
{
    str s;
    s = num2Char(42);
    // Prints an asterisk * -the character represented by 42.
    print s;
}

num2Date

Извлича датата, която съответства на указания брой дни след 1 януари 1900 г.

date num2Date(int _days)

Параметри

параметър Описание
_Дни Броят на дните след 1 януари 1900 г., за които да се върне датата. Бележка: Първата валидна дата е 1 януари 1901 г. Следователно функцията num2Date не връща валидна дата, освен ако _days не е повече от 365.

Стойност на връщане

Датата, която е броят на дните, зададен от параметъра _days след 1 януари 1900 г.

Забележки

num2Date(366); //Returns the date 01/01/1901 (1 January 1901).

num2Str

Преобразува реално число в низ.

str num2Str(real number, int character, int decimals, int separator1, int separator2)

Параметри

параметър Описание
номер Реалното число, което трябва да се преобразува в низ.
знак Минималният брой знаци, които се изискват в текста.
Десетични знаци Необходимият брой цифри след десетичния знак.
разделител1 Стойност на изброяване на DecimalSeparator .
разделител 2 Стойност на изброяване на ThousandSeparator .

Стойност на връщане

Низ, който представя числото.

Забележки

За параметъра decimals максималната стойност е 16. Ако се използва по-голямо число, този метод получава стойност за параметъра decimals от локалния компютър вместо това. И в двата случая се извършва закръгляване. Ето възможните стойности за изброяване за параметъра separator1 :

  • 99 – Автоматично (настройките за форматиране на потребителя определят какъв десетичен разделител се използва), стойност на изброяване DecimalSeparator::Auto
  • 1 – Точка (.), стойност на изброяване DecimalSeparator::D ot
  • 2 – Запетая (,), стойност на изброяване DecimalSeparator::Запетая

Ето възможните стойности за параметъра separator2 :

  • 99 – Автоматично (настройките за форматиране на потребителя определят какъв хиляди разделител се използва)
  • 0 – Няма (без разделител в хиляди), стойност на изброяване ThousandSeparator::None
  • 1 – Точка (.), стойност на изброяване ThousandSeparator::D ot
  • 2 – Запетая (,), стойност на изброяване ThousandSeparator::запетая
  • 3 – Апостроф ('), стойност на изброяване ThousandSeparator::Апостроф
  • 4 – Space ( ), стойност на изброяване ThousandSeparator::Space

Пример

В следващия пример за код първото извикване на метода num2str предоставя 16 за параметъра decimals , а второто повикване предоставя 17.

static void Job_Num2Str(Args _args)
{
    real realNum = 0.1294567890123456777; // 19 decimals places.
    info(Num2Str(realNum, 0, 16, DecimalSeparator::Dot, ThousandSeparator::Space)); // 16 decimal places
    info(Num2Str(realNum, 0, 17, DecimalSeparator::Dot, ThousandSeparator::Space)); // 17 decimal places
}

Изходни данни

Съобщенията са в следния резултат от инфолог. Първото число в резултата съдържа 16 цифри след десетичния знак, докато второто число съдържа само две цифри след десетичния знак.

Message (10:18:12)
0.1294567890123457
0.13

str2Date

Преобразува указания низ в стойност на дата .

date str2Date(str _text, str _sequence)

Параметри

параметър Описание
_Текст Низът за преобразуване в стойност на дата .
_Последователност Трицифрено цяло число, което описва позициите на деня, месеца и годината в низа за конвертиране.

Стойност на връщане

Стойност на дата .

Забележки

Използвайте следните стойности, за да зададете позициите на деня, месеца и годината в параметъра _sequence :

  • Ден: 1
  • Месец: 2
  • Година: 3

Например ако последователността в низа е месец, година и след това ден, параметърът _sequence трябва да бъде 231. Връща се дата 0 (нула), ако входните параметри задават невалидна дата. Следващите два примера задават невалидна дата.

str2Date("31/12/44", 123) // Year must be four digits to reach the minimum of January 1 1901.
str2Date("31/12/2044", 213) // 213 means the month occurs first in the string, but 31 cannot be a month.

Пример

static void str2DateExample(Args _arg)
{
    date d;
    d = str2Date("22/11/2007", 123);
    print d;
}

str2Datetime

Генерира стойност на utcdatetime от зададения низ с информация за дата и час.

utcdatetime str2datetime( str text, int sequence )

Параметри

параметър Описание
SMS Низът за конвертиране в стойност utcdatetime .
Последователност Трицифрено число, което описва последователността на компонентите за дата в текстовия параметър.

Стойност на връщане

Стойност на utcdatetime , която представя указаните дата и час.

Забележки

Изискванията към синтаксиса за частта за дата на текстовия параметър са гъвкави. Разнообразието от валидни формати е същото като във функцията date2str . Всеки от следващите повиквания към str2datetime е валиден и всички те произвеждат един и същ резултат.

utc3 = str2datetime( "1985/02/25 23:04:59" ,321 );
utc3 = str2datetime( "Feb-1985-25 11:04:59 pm" ,231 );
utc3 = str2datetime( "2 25 1985 11:04:59 pm" ,123 );

Всеки компонент от часа на датата се представя с цифра в параметъра за последователност :

  • 1 – Ден
  • 2 – Месец
  • 3 – Година

Например година, месец, ред за ден е 321. Всички валидни стойности съдържат всяка от тези три цифри точно по една. Ако стойността на параметъра на поредицата не е валидна, регионалните настройки се използват за интерпретиране на входния текстов параметър. Ако входните параметри описват невалидна дата и час, се връща празен низ.

Пример

static void JobTestStr2datetime( Args _args )
{
    utcdatetime utc3;
    str sTemp;
    utc3 = str2datetime( "1985/02/25 23:04:59" ,321 );
    sTemp = datetime2str( utc3 );
    print( "sTemp == " + sTemp );
}

str2Enum

Извлича числовия елемент, за който стойността на свойството "Локализиран етикет" съответства на входния низ.

enum str2Enum(enum _type, str _text)

Параметри

параметър Описание
_вид Променлива, която е декларирана от типа на номерирането .
_Текст Локализираният текст на свойството Label на целевия елемент в номерирането.

Стойност на връщане

Елемент от целевото номериране, който също представлява int.

Забележки

Свързаната функция enum2str връща стойността на свойство Label от един елемент в номерирането. Стойността, върната от функцията enum2str , може да бъде входната стойност за параметъра _type на функцията str2enum . Подходяща стойност за параметъра _text е enum2Str(BankAccountType::SavingsAccount). Всеки елемент на една номерация има свойство Име и свойство Етикет . В нова инсталация стойностите на "Име" са почти винаги английски думи. В изданието на английски език стойността на свойството Label е почти винаги еднаква със стойността на име . В изданията, които не са на английски език обаче, стойностите на Label се локализират и следователно не съответстват на стойностите на Name .

Пример

За да избегнете несъответствия между низове, които са причинени от локализация на други говорими езици, ви препоръчваме да използвате функцията enum2str , за да генерирате входа във функцията str2enum . Следващият пример показва подходящия начин за използване на функцията str2enum заедно с функцията enum2str .

static void str2Enum_AcrossLangs(Args _arg)
{
    BankAccountType bat;
    str sEnumValueLabelLocalized;
    int nInt;
    // enum2str.
    sEnumValueLabelLocalized = enum2str(BankAccountType::SavingsAccount);
    info("Localized friendly string: "
        + sEnumValueLabelLocalized);
    // str2enum.
    bat = str2Enum(bat, sEnumValueLabelLocalized);
    nInt = bat;
    info("nInt = " + int2str(nInt));
    /********** Actual output:
    Message (04:32:12 pm)
    Localized friendly string: Savings account
    nInt = 1
    **********/
}

str2Guid

Преобразува низ в GUID обект.

Guid str2Guid(str text)

Параметри

параметър Описание
GUID Низ, който представлява GUID.

Стойност на връщане

GUID, представен от входния низ.

Забележки

Например валидна стойност за параметъра GUID е {12345678-1234-abCD-3456-123456789012} със или без фигурните скоби.

str2Int

Преобразува низ в еквивалентното цяло число.

int str2Int(str _text)

Параметри

параметър Описание
_Текст Низът за преобразуване в цяло число.

Стойност на връщане

Целочислен еквивалент на зададения низ.

Пример

static void str2IntExample(Args _arg)
{
    int i;
    i = str2Int("1234567890");
    print "i = " + int2Str(i);
}

str2Int64

Преобразува низ в int64 стойност.

int str2Int64(str text)

Параметри

параметър Описание
SMS Низът за преобразуване..

Стойност на връщане

Стойността Int64 на зададения низ.

Пример

static void str2Int64Example(Args _args)
{
    str myStr;
    str tooBig;
    Int64 myInt64;
    myStr = "1234567890";
    tooBig = int642str(int64Max()+1);
    myInt64 = str2Int64(mystr);
    print strfmt ("int64: %1",myInt64);
    myInt64 = str2Int64(tooBig);
    print strfmt ("Too big int64: %1",myInt64);
}

str2Num

Преобразува низ в реално число.

real str2Num(str _text)

Параметри

параметър Описание
_Текст Низът за преобразуване в реално число.

Стойност на връщане

Реалното число, ако зададеният низ съдържа валидно число; в противен случай 0 (нула).

Забележки

Следващите примери показват как се използва тази функция.

str2Num("123.45") returns the value 123.45.
str2Num("a123") returns the value 0.0.
str2Num("123a") returns the value 123.00.

Сканирането се извършва от ляво надясно и завършва, когато знак не може да бъде конвертиран в част от реално число.

Пример

static void str2NumToReal(Args _arg)
{
    real r;
    str s;
    r = str2Num("3.15");
    s = strFmt("r = %1", r);
    info(s);
}
/*** Infolog output.
Message_@SYS14327 (02:36:12 pm)
r = 3.15
***/

static void str2NumExponentialSyntax(Args _args)
{
    Qty qty1, qty2, qty3;
    qty1 = str2num('1e-3'); // Bad syntax by the user.
    qty2 = str2num('1.e-3');
    qty3 = str2num('1.0e-3');
    info(strfmt('Result: %1; Expected: %2', num2str(qty1, 0,3,2,0), '0.001'));
    info(strfmt('Result: %1; Expected: %2', num2str(qty2, 0,3,2,0), '0.001'));
    info(strfmt('Result: %1; Expected: %2', num2str(qty3, 0,3,2,0), '0.001'));
}
/*** Infolog output. The first result differs from expectations.
Message_@SYS14327 (02:20:55 pm)
Result: 1,000; Expected: 0.001
Result: 0,001; Expected: 0.001
Result: 0,001; Expected: 0.001
***/

str2Time

Преобразува низ в стойност timeOfDay .

int str2Time(str _text)

Параметри

параметър Описание
_Текст Времето, което трябва да се използва за изчисляване на броя на секундите от полунощ.

Стойност на връщане

Броят на секундите между полунощ и параметъра _text ; в противен случай , -1.

Забележки

str2Time("05:01:37") //Returns the value 18097.
str2Time("7 o'clock") //Returns the value -1.

Пример

static void str2TimeExample(Args _arg)
{
    int i;
    i = str2Time("11:30");
    print i;
}

time2Str

Преобразува стойност за timeOfDay в низ, който включва часове, минути и секунди.

str time2Str(int _time, int _separator, int _timeFormat)

Параметри

параметър Описание
_Час Стойност за timeOfDay .
_сепаратор Стойност на изброяване timeSeparator , която показва знаците между часовете, минутите и секундите в изходния низ.
_timeFormat Стойност на изброяване timeFormat , която показва дали се използва 12-часов или 24-часов часовник.

Стойност на връщане

Низ, представящ указания час.

Забележки

Стойността на параметъра _time е броят секунди от полунощ.

Пример

static void TimeJob4(Args _args)
{
    timeOfDay theTime = timeNow();
    info( time2Str(theTime, TimeSeparator::Colon, TimeFormat::AMPM) );
}
/**
Message (04:33:56 pm)
04:33:56 pm
**/

uint2Str

Преобразува цяло число в низ. Предположението е, че цяло число е неподписано.

str uint2Str(int integer)

Параметри

параметър Описание
цяло число Цяло число за конвертиране.

Стойност на връщане

Низът, еквивалентен на указаното неподписано цяло число.

Забележки

Използвайте тази функция вместо функцията int2str за много големи цели числа, като например идентификатори на записи.

info(int2str(3123456789)); //returns -1171510507 as a string.
info(uint2str(3123456789)); //returns 3123456789 as a string.