IBM FileNet P8, Version 5.2.1            

Дерек түрінің түрлендіру функциясы

Бұл бөлімде, өрнектерді бір дерек түрінен басқасына түрлендіретін функциялардың қысқаша сипаттамасы бар.

Кесте 1. Бір дерек түрін басқасына түрлендіретін функциялар үстелі
Функция Ол не істейді
convert Бір қолданған дерек түрінен басқа түріне өрнекті түрлендіреді.
numbertostring Бүтін сан немесе қалқыма өрнегін, көрсетілген бүркенішті қолдана отыра, жол өрнегіне түрлендіреді.
stringtotime Жол өрнегін, көрсетілген бүркенішті қолдана отыра, уақыт өрнегіне түрлендіреді.
timetostring Уақыт өрнегін, көрсетілген бүркенішті қолдана отыра, жол өрнегіне түрлендіреді.
is_valid Көрсетілген қарапайым дерек түріне түрленетін, көрсетілген өрнектің жарамды мән екенін анықтайды.

түрлендіру

Бұл функция, өрнекті бір қолданған дерек түрінен басқасына түрлендіреді. Келесі синтаксисті пайдаланыңыз:
түрлендіру (source_expr, type_name)
мұнда:
Кесте 2. Түрлендіру функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
source_expr Әрбір қолданған дерек түрінің өрнегі. Бұл өрнек type_name функциясында көрсетілген дерек түріне түрленеді.
type_name

source_expr функциясы түрленетін деректер түрі. Жарамды ендірулер - қалқыма, қалқыма[ ], бүтін сан, бүтін сан[ ], жол, жол[], Қисындық, Қисындық[ ], уақыт, және уақыт[ ].

Ескеріңіз, егер type_name мәні төрт бұрышты жақшамен ([ ]) берілсе, онда source_expr мәні жиым болуы керек. Жиымдағы әрбір элемент, қарапайым дерек түріне қолданатын ережелер арқылы type_name мәніне түрленеді.

Түрлендіру функциясының нәтижелері, source_exp және type_name мәнінің қайнар көзіне байланысты өзгереді.

Ескерту: Түрлендіру функциясын белгілі деректер түрі тіркесімімен қолдану синтаксистік қатеге алып келетінін біліңіз. Мысалы, уақыт дерек түрін, Қисындық дерек түріне түрлендіру қисынға симайды, сондықтан синтаксистік қате пайда болады. Қажетті жағдайда, is_valid функциясын, түрлендіру функциясындағы сол өрнекті қолданудан бұрын өрнектің түрін тексеру үшін қолданыңыз

Қисындықтан түрлендіру

Егер source_expr мәні Қисындық түр болса, түрлендіру функциясының нәтижесі келесідей болады.

Кесте 3. Дерек түрі Қисындық түр болған кездегі, түрлендіру функциясының нәтижелері
Қисындық түрден түрлендіру... Нәтижелер
Қисындық Өзгеріс жоқ.
қалқыма Егер Қисындық өрнек true болса, нәтиже - 1 болады; егер Қисындық өрнек қате болса, нәтиже - 0 болады.
бүтін сан Егер Қисындық өрнек true болса, нәтиже - 1 болады; егер Қисындық өрнек қате болса, нәтиже - 0 болады.
жол Егер Қисындық өрнек true болса, нәтижесі "true" болады; егер Қисындық өрнек қате болса, нәтижесі "қате" болады.
уақыт Синтаксистік қате.

Қалқымадан түрлендіру

Егер source_expr мәні қалқыма түрі болса, түрлендіру функциясының нәтижелері келесідей болады.

Кесте 4. Дерек түрі қалқыма түрі болған кездегі, түрлендіру функциясының нәтижелері
Қалқымадан түрлендіру... Нәтижелер
Қисындық

Егер source_expr = 0 болса, нәтиже қате болады; егер source_expr = 1 болса, нәтиже true болады.

Егер source_expr <> 0 немесе 1 болса, синтаксистік қате нәтижесі болады.

қалқыма Өзгеріс жоқ.
бүтін сан source_expr мәнінің бүтін сан бөлігін түрлендіреді(ол, ондық үтірдің оң жағына қарай барлық санды қысқартады). Егер нәтиже бүтін сандардың ауқымында болмаса, қате пайда болады.
жол Қалқыманы ұсынатын сандық таңбалардың жолындағы нәтижелер.
уақыт

source_expr мәнінің бүтін сан бөлігін екіншілерінің саны сияқты 1/1/1970 00:00:00 UTC (Реттелген әмбебап уақыт) уақытына қосу үшін қолданыңыз; жаңа уақытты қайтарады.

UTC (Реттелген әмбебап уақыт) Бұрын GMT (Гринвич бойынша орташа уақыт) сияқты белгілі болған, UTC уақыты - стандартты бүкіл әлемдік сілтемелі уақыт белдеуі.

Мысалы, қайтарылатынды (5.3, уақыты) түрлендіру 1/1/1970 00:00:05.

Бүтін саннан түрлендіру

Егер source_expr мәні бүтін сан түрі болса, түрлендіру функциясының нәтижелері келесідей болады.
Кесте 5. Дерек түрі бүтін сан түрі болған кездегі, түрлендіру функциясының нәтижелері
Бүтін санна түрлендіру... Нәтижелер
Қисындық

Егер source_expr = 0 болса, нәтиже қате болады; егер source_expr = 1 болса, нәтиже true болады.

Егер source_expr <> 0 немесе 1 болса, синтаксистік қате нәтижесі болады.

қалқыма Эквивалентті қалқыма мәніндегі нәтижелер.
бүтін сан Өзгеріс жоқ.
жол Бүтін санды ұсынатын сандық таңбалардың жолындағы нәтижелер.
уақыт

source_expr мәнін, екіншілерінің саны сияқты 1/1/1970 00:00:00 UTC (Coordinated Universal Time) уақытына қосу үшін қолданыңыз; жаңа уақытты қайтарады.

Мысалы, қайтарылатынды (5, уақыт) түрлендіру 1/1/1970 00:00:05.

Жолдан түрлендіру

Егер source_expr мәні жол түрі болса, түрлендіру функциясының нәтижелері келесідей болады.

Кесте 6. Дерек түрі жол түрі болған кездегі, түрлендіру функциясының нәтижелері
Жолдан түрлендіру... Нәтижелер
Қисындық Егер source_expr = "true" немесе source_expr = "қате" болмаса, синтаксистік қате пайда болады. (Бас және кіші әріптердің тіркесімі рұқсат етіледі.)
қалқыма Егер source_expr мәні қалқыма мәнінің куәлік көрінісі болмаса, синтаксистік қате пайда болады.
бүтін сан Егер source_expr мән бүтін санның куәлік көрінісі болмаса, синтаксистік қате пайда болады.
жол Өзгеріс жоқ.
уақыт

Егер source_expr мәні уақыт мәнінің куәлік көрінісі және жұмыс ағынының жүйесі үшін күн/уақыт бүркенішінде көрсетілген пішінді қолданатын болмаса, синтаксистік қате пайда болады.

Уақытты түрлендіру

Егер source_expr мәні уақыт түрі болса, түрлендіру функциясының нәтижесі келесідей болады.

Кесте 7. Дерек түрі уақыт түрі болған кездегі, түрлендіру функциясының нәтижелері
Уақыттан түрлендіру... Нәтижелер
Қисындық Синтаксистік қате.
қалқыма

Ағымдағы жүйе уақыты мен 1/1/1970 00:00:00 UTC (Реттелген әмбебап уақыт) уақыты арасындағы екінші санды қайтарады.

Мысалы, егер SysTime = 1/1/1970 00:00:28 UTC болса, (SysTime, қалқыма) қайтарылатын 28 санын түрлендіріңіз.

Егер ағымдағы жүйе уақыты UTC уақытынан басқа уақыт белдеуіне орнатылса, түрлендіру функциясы қажетті түзету жасайды. Мысалы, Тынық мұхиттық уақыты және UTC уақыты арасында 8-сағат айырмашылық бар; егер SysTime = 1/1/1970 00:00:28 PST және жергілікті уақыт белдеуі PST болса, онда (SysTime, бүтін сан) қайтарылатын 28828.0 санын түрлендіріңіз.

8(сағат) * 60(минут) *60(секунд) + 28(секунд)

бүтін сан

Ағымдағы жүйе уақыты мен 1/1/1970 00:00:00 UTC (Реттелген әмбебап уақыт) уақыты арасындағы екінші санды қайтарады.

Мысалы, егер SysTime = 1/1/1970 00:00:28 UTC уақыты болса, (SysTime, бүтін сан) қайтарылатын 28 санын түрлендіріңіз.

Егер ағымдағы жүйе уақыты UTC уақытынан басқа уақыт белдеуіне орнатылса, түрлендіру функциясы қажетті түзету жасайды. Мысалы, PST және UTC уақыты арасында 8-сағат айырмашылық бар; егер SysTime = 1/1/1970 00:00:28 PST және жергілікті уақыт белдеуі Тынық мұхиттық уақыты болса, онда (SysTime, бүтін сан) қайтарылатын 28828 санын түрлендіріңіз.

8(сағат) * 60(минут) *60(секунд) + 28(секунд)

жол

source_expr мәнінің жол көрінісіндегі нәтижелер. Бұл жол, жұмыс ағынының жүйесі үшін күн/уақыт бүркенішінде көрсетілген пішімді қолданатынын ескеріңіз.

уақыт Өзгеріс жоқ

numbertostring функциясы

Бұл функция, көрсеткен пішімді қолданып, қалқыма немесе бүтін санды жол өрнегіне түрлендіреді. Нақты пішімдегі (мысалы, $1,000,000) санды көрсеткен кезде, осы функцияны қолданыңыз. Сонымен қатар numbertostring функциясын сандарды домалақтау үшін қолданыңыз.

Келесі синтаксисті пайдаланыңыз:
numbertostring функциясы (num_exp{, num_mask}opt)
мұнда:
Параметр Сипаттама
num_exp Қалқыма түрінің немесе бүтін сан түрінің өрнегі.
num_mask

numbertostring функциясының шығару пішімін анықтайтын сандық бүркеніш мәні.

Міндетті емес кезде ескеріңіз, егер сандық бүркенішті енгізбеген болсаңыз, numbertostring функциясы, түрлендіру функциясына эквивалентті болады.

Сандық бүркеніш

Сандық бүркеніш, numbertostring функциясының шығару пішімін қолданатын үлгі. Сандық бүркеніш, құрамында келесі құрамдастардың әртүрлі жарамды тіркесімі бар, жол өрнегі болып табылады.

құрамдас бөлік Мағына
+ (қосу)

Бүркеніштегі алғашқы немесе соңғы құрамдас, санның белгісін көрсеткен кезде.

Алғашқы немесе соңғы орындарда, қосу белгісі бүркеніште қай жерге қойылған болса, шығару жолында да сол жерге кірістіріледі. Мысалы:

numbertostring функциясы (12345, "###+##")

шығарулар 123+45

- (алу)

Бүркеніште алғашқы немесе соңғы құрамдас, егер сан теріс болса немесе бос орынды көрсетсе, егер сан true болса, онда теріс белгіні көрсетеді.

Алғашқы немесе соңғы орындардан басқа орын кезінде, алу белгісі, бүркеніште қай жерге қойылған болса, шығару жолында да сол жерге кірістіріледі. Мысалы:

numbertostring функциясы (123456789, "###-##-####")

шығарулар 123-45-6789

# (сан белгісі) Егер ол адам болса, санды көрсетеді. Бүркеніште #s адамдар саны көп болса, rightmost #s сандарды бірінші болып алады және артық #s бос орындармен толтырады.
0 (нөл) Санның адам немесе адам емес екенін көрсетеді; екі басы бойынша және соңы бойынша нөлдер нәтиже болады.
. (ондық) Ондық үтірдің қайда жүргенін анықтайды. Егер көрсетілмеген болса, ондық үтір бүркеніштің оң жақ соңына болжанады. Сан бүркенішке сәйкестендіру үшін домалақтандырылды. Тек қана бір ондық үтірге, бүркеніште болуға рұқсат етіледі.

Сандық бүркеніштердің үлгісі

numbertostring функциясы келесі сандарды түрлендірген кездегі, шығару нәтижесі төменде берілген: 0, +29, -3344, және 77.88369. Көрсетілген сандық бүркеніштер бойынша шығару пішімделеді.

Ескерту: Егер бүркеніш сан үшін тым кішкентай болса, қате пайда болады. Егер ондық үтірдің сол жағына қарай тым аз #s немесе 0-дер болса, бүркеніш тым кішкентай болады. Мысалы, ## бүркеніші 300 санына жеткіліксіз.
Бүркеніш 0 +29 -3344 77.88369
0000 0000 0029 3344 0078
####   29 3344 78
$#,### $ $29 $3,344 $78
+#### + +29 -3344 +78
-####   29 -3344 78
####+ + 29+ 3344- 78+
####- 29 3344- 78
##.## . 29. Орындау уақытының қателігі 77.88

Сандарды домалақтау

Сандарды домалақтау үшін, numbertostring функциясын және тиісті сандық бүркенішті қолданыңыз. Әрбір сан бүркеніштегі соңғы орынға сәйкестендіру үшін домалақтанады. Келесі мысал санды мыңға домалақтайды. Мысалда, Number1 - қалқыма түрі өрнегінің атауы.
numbertostring функциясы (Number1, "#,###.###")
Егер Number1 = 3344.7788 болса, шығару нәтижесі:
3,344.779 болады

is_valid

Бұл функция, көрсетілген өрнектің көрсетілген қарапайым дерек түріне түрленетін жарамды мән екенін анықтайды. Егер өрнек жарамды болса, бұл функция true Қисындық мәнді қайтарады; кері жағдайда, функция қате мәнді қайтарады. Түрлендіру функциясында сол өрнекті қолданудан бұрын, is_valid функциясы арқылы өрнек түрін тексеру пайдалы болады. Келесі синтаксисті пайдаланыңыз:
is_valid (expr, type)
мұнда:
Кесте 8. is_valid функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
expr Әртүрлі өрнек.
түр Қарапайым деректер түрі (Қисындық, қалқыма, бүтін сан, жол, уақыт).
Төменде жол өрнегін қолданатын екі мысал берілген. Бірінші мысал дұрысты қайтарады, екінші мысал қатені қайтарады. Бірінші мысалда, str = "true".
is_valid (str, Қисындық)
is_valid ("1.2.3", қалқыма)
Төмендегі мысал, көрсетілген қалқыма өрнегі, бүтін сан түріне түрленуге жарамды екенін тексереді;бұл мысал қате мәнді қайтарады өйткені қалқыма мәні, жарамды бүтін сан мәнінің ауқымынан тыс.
is_valid (1e20, бүтін сан)


Last updated: March 2016
bpfe005.htm

© IBM корпорациясының авторлық құқықтары 2016.