تحويل العملات والوحداتمرجع
تحويل العملات والوحدات. قاعدة calc تحوّل مبلغًا إلى عملة أخرى، أو كمية إلى وحدة أخرى، وتخزّن النتيجة. اكتب التحويل في عمود Value — يصبح الحقل الهدف للقراءة فقط ويُعاد حسابه عند كل حفظ للسجل (ويتحدّث مباشرةً أثناء الكتابة). تتوفر أربع دوال — اثنتان تقرآن جداول تحويل في مصنّفك، واثنتان لا تحتاجان إلى أي جداول:
| الدالة | ما تفعله |
|---|---|
currency_conversion(amount, from, to) | تحوّل المبلغ باستخدام جدول Exchange Rates الخاص بمصنّفك. |
unit_conversion(quantity, from, to) | تحوّل الكمية باستخدام جدول Unit Conversions الخاص بمصنّفك. |
currency_conversion_api(amount, from, to, date) | تحوّل باستخدام أسعار صرف مباشرة — دون الحاجة إلى جدول. الوسيط date اختياري (انظر أدناه). |
unit_conversion_api(quantity, from, to) | تحوّل باستخدام جدول الوحدات المدمج في SheetApps — دون الحاجة إلى جدول. |
ما هي الوسائط. تأخذ كل دالة أولاً القيمة المراد تحويلها — حقل المال أو الكمية — ثم رمزَي from وto؛ ويأخذ currency_conversion_api وسيطاً رابعاً اختيارياً هو date. القيمة الفارغة تبقى فارغة (وليست 0)، وتحمل النتيجة دائماً رمز الهدف — والرمز الحرفي "EUR" يثبّت الحقل على اليورو على الشاشة وفي التصدير.
يمكن أن تكون الرموز ثابتة أو خاصة بكل سجل. اكتب from وto كرمز ثابت بين علامتي اقتباس ("EUR")، أو كـاسم حقل (currency) ليحوّل كل سجل من عملته أو وحدته الخاصة — مثلاً تحوّل currency_conversion(total_amount, currency, "EUR") إجمالي كل طلب إلى اليورو. ويمكنك إجراء عمليات حسابية حول التحويل أيضًا (… * 1.02).
تحويلات الجداول تقرأ ورقتَي بحث محجوزتين: Exchange Rates بالأعمدة From · To · Rate، وUnit Conversions بالأعمدة From · To · Factor. يستخدم SheetApps الزوج المطابق تمامًا، أو عكسه، أو ×1 للرمز نفسه؛ وإذا كان الزوج مفقودًا فإنه يمنع الحفظ ويخبرك أي زوج تضيفه. حرّر هذه الجداول في أي وقت من البيانات الرئيسية — دون الحاجة إلى إعادة الرفع.
تحويلات API لا تحتاج جداول. يجلب currency_conversion_api أسعار البنك المركزي الأوروبي المرجعية المباشرة من خدمة Frankfurter المجانية بلا مفتاح (frankfurter.dev): مرّر date (حقل تاريخ، أو تاريخ ISO مثل "2026-07-01") للتحويل بسعر ذلك اليوم، أو اتركه لسعر اليوم. يستخدم unit_conversion_api جدولاً مدمجاً يغطي الوحدات الشائعة للكتلة والطول والمساحة والحجم والحرارة والزمن (رموز UNECE وأسماء يومية مثل kg وlb وft و°C). كلاهما يعمل في الحزم المنشورة متى كان للحاسوب المشغِّل إنترنت.
currency_conversion_api تحويل زوج غير مُدرَج، ويمنع الحفظ برسالة تسمّي الزوج. لأي عملة غير مغطّاة، استخدم currency_conversion القائمة على الجدول وزوّد السعر بنفسك: أضِف صف From · To · Rate إلى ورقة Exchange Rates، أو حافظ عليه في البيانات الرئيسية للتطبيق.Total EUR دائمًا باليورو، مهما كانت العملة التي أُدخل بها الطلب. وإذا تعذّر جلب سعر مباشر ولم يكن هناك سعر مخزَّن مؤقتًا، يُمنع الحفظ حتى تتوفر خدمة الأسعار؛ ويمنع الزوج المفقود في الجدول الحفظ بالطريقة نفسها.