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