Сандар мен күнтізбелік мәндерді тану, қалыпқа келтіру және пішімдеу.
Мақсаты
Сандар немесе күндер бар өрістерге бөлек ережелер анықтайды. Мәтіндік жазылымды тазалайды, айналасындағы мәтіннен сан/күн алады, есептеуге жарамды мәнге айналдырады немесе есеп мәтіні ретінде пішімдейді.
Кірістер және шығыстар
Бір in кірісі және out шығысы. Сандық ережелер таңдалған өрістерді өзгертеді; күн ережелері күн бөліктерінің бағандарын жасап, бастапқы өрісті жоя алады.
Параметрлер
| Параметр | Баптаулар және мәндер | Нұсқалар және шектер |
|---|
rules | Реттелген ережелер тізімі. Шарттар мен параметрлер төменде сипатталған. | Саны: 0–256 |
Ортақ ереже баптаулары
| Параметр | Нені баптайды |
|---|
field | Өріс немесе «Барлық басқа өрістер» үшін бос мән. |
replacements | Алдын ала табу → алмастыру ережелері; whole бүкіл мәнге, case_sensitive регистрге қатысты; 100 алмастыруға дейін. |
extract | Басқа сөздер/таңбалар арасынан сан немесе күн табу. |
invalid | keep арқылы сақтау, null арқылы тазалау немесе error арқылы тоқтату. |
Сан баптаулары
| Параметр | Нені баптайды |
|---|
decimal_in / thousands_in | Кіріс ондық және мыңдық бөлгіштері; auto немесе нақты таңдау. |
parentheses_negative | Жақшадағы санды теріс деп қабылдау. |
percent | keep алынған соманы сақтайды; fraction пайызды үлеске айналдырады. |
divisor | Бірлік, мың немесе миллион үшін 1, 1000 не 1000000-ға бөлу. |
digits / rounding | 0–15 ондық таңба немесе дәлдікті көрсетпеу. Режимдер: half_up/half_even/half_down/down/up/floor/ceiling. |
sign | Таңбаны сақтау, оң немесе теріс ету. |
output | Есептеуге number; пішімделген мәтінге text. |
decimal / thousands / prefix / suffix | Мәтіндік нәтиже көрінісі: бөлгіштер, префикс және суффикс. |
Күн баптаулары
| Параметр | Нені баптайды |
|---|
order | Кіріс күн бөліктерінің реті үшін auto, dmy, mdy немесе ymd. |
output / time | Нәтиже date, text немесе parts; қажет болса уақытты сақтау. |
pattern / language | Мәтіндік күн үлгісі, әдепкі DD.MM.YYYY; атау тілі uk/ru/en. |
parts | Бөліктер: year, quarter, month, month_name, week, day, weekday; әрқайсысына жаңа өріс атауын беріңіз. |
parts_output | Бөліктердің сандық немесе мәтіндік көрінісі. |
original | Бөліктерді алғанда бастапқы өрісті keep арқылы сақтау, date арқылы күнге қалыпқа келтіру немесе remove арқылы жою. |
Қадамдық баптау
- Нақты өріске немесе «Барлық басқа өрістерге» ереже қосыңыз.
- Сан немесе күн таңдаңыз. Алдын ала мәтін алмастыруларын қосып, мәтін ішінен мән іздеу қажеттігін анықтаңыз.
- Тануды баптаңыз: сан бөлгіштері немесе күн бөліктерінің реті.
- Шығысты таңдаңыз: кейінгі әрекеттерге сан/күн немесе есепке мәтін. Жарамсыз мәндер әрекетін орнатыңыз.
- Жергілікті пішімдер, жақшалар, пайыздар және екіұшты күндер бар жолдарды тексеріңіз.
Ережелер және диагностика
- Өрісі бос ереже жеке ережелерде аталмаған басқа өрістерге қолданылады.
- invalid=keep танылмаған мәнді сақтайды, null тазалайды, error өңдеуді тоқтатады. Басқарылатын жүктеу үшін ережені саналы таңдаңыз.
- Мәтіндік шығыс көрсетуге арналған; арифметика алдында output=number сақтаңыз немесе қайта қалыпқа келтіріңіз.
- Пайыздарды мәтінде табылған сан ретінде сақтауға немесе үлеске айналдыруға болады: percent=fraction кезінде 15% → 0.15.
- Күн бөліктерінің атаулары бірегей болып, нәтижедегі атаулармен қайшы келмеуі керек.
- output=parts үшін бір нақты күн өрісін және кемінде бір бөлікті таңдаңыз; «Барлық басқа өрістер» ережесі күн бөлігі бағандарын жасамайды.
- Кіріс ондық және мыңдық бөлгіштері әртүрлі болуы керек; мәтіндік нәтижеге де сол талап қолданылады.
Баптау мысалы
Amount үшін kind=number, decimal_in=",", thousands_in=" ", extract=true, output=number, invalid=error орнатыңыз. «1 234,56 UAH» мәтіні 1234.56 санына айналады. DateText үшін kind=date, order=dmy, output=parts таңдап, Year және Month жасаңыз.