دوال locale وpictures في FormCalc
فعّل TXFAWidgetRuntimeOptions.ScriptOptions.EnableJavaScript لاستخدام هذه الدوال في أحداث FormCalc العامة وسكربتات الحساب والتحقق عبر محرك QuickJS المرفق
انتقاء locale
الحقل المنفَّذ يرث أقرب سمة locale غير فارغة من أسلافه؛ والسلسلة الفارغة تنتقي locale لـ ICU الأصلي المهيأ على Windows أو Linux
مدخل localeSet للمستند يتجاوز رموز الأعداد/العملات الأصلية وأسماء الشهور/الأيام/الـ meridiem وأنماط التاريخ/الوقت/الأعداد؛ والقيم المفقودة ترث بيانات النظام، مع fallback بقيمة en_US لأسماء locale مخصصة
معرّفات locale تقبل هجاءتَي الشرطة السفلية والشرطة بلا حالة أحرف؛ والأسماء المحسوبة مثل Concat("de", "_DE") تُحل لحظة التنفيذ
طلبات locale الداخلية تتشارك موعد الحدث النهائي وتسمح بـ 64 بحثًا مسنّى و256 وحدة UTF-16 code لكل معرّف و2 MiB من metadata تراكميًا؛ وإعادة المحاولة تستعيد نقطة فحص JavaScript، وإعادة تشغيل الجلسة المُرسَلة تستهلك metadata مسجَّلة دون استدعاء مزوّد آخر
دوال الصور
| الدالة | السلوك |
|---|---|
Format(picture, value, ...) | تنسّق القيم ببنود date وtime وdatetime وnum أو text؛ والبنود المركبة القياسية تنسّق نفس القيمة، مع امتداد اختياري يقبل وسائط قيم مقابلة |
Parse(picture, text) | تحل بنودًا مكتوبة النوع أو مركبة أو بدائل إلى نص ISO للتاريخ/الوقت أو نص عشري عددًا أو نصًا بلا حرفيات |
استخدم date(de_DE){D. MMMM YYYY} لـ locale صريح وnum.currency لأسلوب locale وشريطًا عموديًا للبدائل؛ والحرفيات المقتبسة والفواصل العلوية المضاعفة تحفظ المحارف الحرفية
أنماط date وtime وdatetime تستخدم الأنماط default وshort وmedium وlong وfull المحلولة؛ ونمط الأعداد في localeSet القياسي يزوّد num.decimal وجزءها الصحيح للـ num.integer
صور التاريخ/الوقت تدعم السنة والشهر واليوم وأسماء أيام الأسبوع وساعات 12/24 والدقائق والثواني ومللي ثانية كسرية والـ meridiems وإزاحات GMT/UTC صريحة؛ والتواريخ غير الصالحة مثل 30 فبراير تعيد نصًا فارغًا
الصور العددية تدعم 9 إلزاميًا وz اختياريًا وZ محشوة بفراغ وفواصل عشر/تجميع ورموز عملات وأكواد عملات ISO ونسبًا مئوية وإشارات وأقواسًا ولاحقات credit/debit وجذرًا عشريًا ضمنيًا
صور النص تدعم A لحروف Unicode وO أو 0 لمحارف Unicode أبجدية عددية و9 لأرقام وX لنقاط شيفرة Unicode، بما يشمل المحارف التكميلية
بنود الصور المتقدمة تضيف ترميزًا علميًا عدديًا ودقة كسرية محفوظة وتواريخ ترتيبية وأسبوعية وساعات إضافية ورموز محارف/فراغ عامة وتحليل إدخال مركبًا
معاملات null تعيد null؛ والصور غير الصالحة أو القيم غير الصالحة أو locales غير المتاحة تعيد نصًا فارغًا
target = Format("num(de_DE){z,zz9.99}", 1234.5)
target = Parse("date{MMM D, YYYY}", "Sep 1, 2002")
target = Format("date{YYYY-MM-DD} 'at' time{HH:MM}", "2024-03-15T13:45:09")دوال التاريخ والوقت
| الدالة | المعاملات والنتيجة |
|---|---|
DateFmt(style=0, locale), TimeFmt(style=0, locale) | تعيدان أنماط XFA للافتراضي 0 وshort 1 وmedium 2 وlong 3 أو full 4؛ والأنماط غير الصالحة تنتقي الافتراضي |
Date2Num(text, picture, locale) | تعيد أيامًا مسلسلة مع 1900-01-01 يومًا أولًا؛ والصورة الغائبة تستخدم افتراضي locale وتقبل أيضًا تواريخ ISO |
Num2Date(serial, picture, locale) | تنسّق أيامًا مسلسلة بصورة تاريخ locale المقدَّمة أو الافتراضية |
IsoDate2Num(text) | تحل تواريخ ISO مدمجة أو مشغوبة بشرطة، بما يشمل لاحقات وقت اختيارية |
IsoTime2Num(text), Time2Num(text, picture, locale) | تعيدان مللي ثانية منذ منتصف ليل GMT زائد 1؛ والإزاحات الصريحة تُطبق والغائبة تستخدم المنطقة الزمنية الحالية |
Num2GMTime(serial, picture, locale), Num2Time(serial, picture, locale) | تنسّقان مسلسلات وقت من 1 إلى 86400000 بـ GMT أو المنطقة الزمنية الحالية |
Date(), Time() | تعيدان مسلسلات التاريخ/الوقت الحاليين مع مدخلات ساعة مسجَّلة خلال إعادة تشغيل الجلسة |
صور Num2Date الغائبة تنتج الآن مخرجًا محليًا؛ وارحل المستدعين المطلبين مخرج ISO إلى Num2Date(serial, "YYYY-MM-DD")
الوحدات والترميز وأدوات النص
| الدالة | المعاملات والنتيجة |
|---|---|
UnitType(measurement) | تتعرف على aliases لـ in وcm وmm وpt وpc وmp؛ والوحدات غير المعروفة تقصّر افتراضيًا إلى بوصة |
UnitValue(measurement, targetUnit="in") | تحوّل القياسات بـ 72 نقطة لكل بوصة و12 نقطة لكل pica و1000 ميلي نقطة لكل نقطة |
Encode(text, encoding="url"), Decode(text, encoding="url") | تدعم هروب URL وكيانات XML وكيانات HTML المسنّاة أو العددية بتحقق Unicode scalar |
Uuid(style=0) | تعيد 32 رقمًا سداسيًا عشريًا أو النمط 1 بشرطات، بتذييل إصدار 4 وبتات variant؛ وإعادة التشغيل تستخدم مدخلات random مسجَّلة |
WordNum(value, style=0, locale) | تنتج كلمات أعداد إنجليزية أو مبالغ دولارات بالنمط 1 أو دولارات وسنتات بالنمط 2؛ والنطاقات العددية غير الصالحة تعيد نجمة |
حدود الصور الحالية
العصور البديلة والتمثيلات إيديوغرافية أو ذات العرض الكامل وأبجديات الأرقام المحلية ورموز الأنماط المعروضة المحلية فقط وسياسات التجميع الكاملة تبقى أهدافًا منفصلة؛ وWordNum تصدر كلمات إنجليزية
مقيّم scalar الأصلي يحفظ دوال ISO وfinance القائمة لديه؛ ودوال locale/picture تتطلب التنفيذ العام
واجهات أدنى مستوى
TXFALocaleData, HPDFXFALoadLocale, HPDFXFALoadDocumentLocale وHPDFXFALocaleJavaScript تكشف metadata locale بـ Unicode وتسلسل محرك آمنًا
HPDFXFAExecuteJavaScriptEvent تقبل TXFALocaleDataProvider لبحث metadata مخصص للقراءة فقط