يتم توليد الوثائق أدناه من جدول النظام
system.functionsfinancialInternalRateOfReturn
cashflows— مصفوفة من التدفقات النقدية. تمثل كل قيمة دفعة (قيمة سالبة) أو دخلاً (قيمة موجبة).Array(Int8/16/32/64)أوArray(Float*)[, guess]— قيمة تخمين أولية اختيارية (قيمة ثابتة) لمعدل العائد الداخلي (القيمة الافتراضية 0.1).Float*
NaN إذا تعذّر تقارب الحساب، أو كانت مصفوفة الإدخال فارغة أو تحتوي على عنصر واحد فقط، أو كانت جميع التدفقات النقدية صفراً، أو حدثت أخطاء حسابية أخرى. Float64
أمثلة
simple_example
Query
Response
Query
Response
financialInternalRateOfReturnExtended
مُقدَّم في: v25.7.0 يحسب معدل العائد الداخلي الموسَّع (XIRR) لسلسلة من التدفقات النقدية التي تقع على فترات غير منتظمة. XIRR هو معدل الخصم الذي تنعدم عنده صافي القيمة الحالية (NPV) لجميع التدفقات النقدية. يسعى XIRR إلى حل المعادلة التالية (مثال لـACT_365F):
يجب أن تكون المصفوفات مرتَّبة بحسب التاريخ تصاعديًا، وأن تكون التواريخ فريدة.
Syntax
cashflow— مصفوفة من التدفقات النقدية المقابلة للتواريخ في المعامل الثاني.Array(Int8/16/32/64)أوArray(Float*)date— مصفوفة مرتَّبة من التواريخ الفريدة المقابلة للتدفقات النقدية.Array(Date)أوArray(Date32)[, guess]— اختياري. التخمين الأولي (قيمة ثابتة) لحساب XIRR.Float*[, daycount]— اصطلاح احتساب الأيام اختياري (القيمة الافتراضية ‘ACT_365F’). القيم المدعومة:- ‘ACT_365F’ - فعلي/365 ثابت: يستخدم العدد الفعلي للأيام بين التواريخ مقسومًا على 365
- ‘ACT_365_25’ - فعلي/365.25: يستخدم العدد الفعلي للأيام بين التواريخ مقسومًا على 365.25
String
Float64
Examples
simple_example
Query
Response
Query
Response
Query
Response
financialNetPresentValue
start_from_zero = true):
\sum_{i=0}^{N-1} \frac{values_i}{(1 + rate)^i}
الصيغة المتوافقة مع Excel (start_from_zero = false):
\sum_{i=1}^{N} \frac{values_i}{(1 + rate)^i}
البنية
rate— معدل الخصم المطلوب تطبيقه.Float*cashflows— مصفوفة من التدفقات النقدية. تمثل كل قيمة دفعة (قيمة سالبة) أو دخلاً (قيمة موجبة).Array(Int8/16/32/64)أوArray(Float*)[, start_from_zero]— معلمة منطقية اختيارية تشير إلى ما إذا كان يجب بدء حساب NPV من الفترة0(true) أو من الفترة1(false، متوافق مع Excel). القيمة الافتراضية: true.Bool
Float64
أمثلة
default_calculation
Query
Response
Query
Response
financialNetPresentValueExtended
Introduced in: v25.7.0 تحسب دالة صافي القيمة الحالية الممتدة (XNPV) لسلسلة من التدفقات النقدية التي تحدث بفترات غير منتظمة. تأخذ XNPV في الاعتبار توقيت كل تدفق نقدي عند حساب القيمة الحالية. معادلة XNPV للمعيارACT_365F:
يجب أن تكون المصفوفات مرتبة حسب التاريخ بترتيب تصاعدي. يجب أن تكون التواريخ فريدة.
هذه الدالة غير حتمية: قد تُرجع نتائج مختلفة لنفس الوسائط.
rate— معدل الخصم الذي يُطبق.Float*cashflows— مصفوفة التدفقات النقدية. تمثل كل قيمة دفعة (قيمة سالبة) أو دخل (قيمة موجبة). يجب أن تحتوي على قيمة موجبة واحدة على الأقل وقيمة سالبة واحدة على الأقل.Array(Int8/16/32/64)orArray(Float*)dates— مصفوفة التواريخ المقابلة لكل تدفق نقدي. يجب أن يكون حجمها مساويًا لمصفوفة التدفقات النقدية.Array(Date)orArray(Date32)[, daycount]— اصطلاح اختياري لاحتساب الأيام. القيم المدعومة:'ACT_365F'(الافتراضي) — Actual/365 Fixed،'ACT_365_25'— Actual/365.25.String
Float64
Examples
Basic usage
Query
Response
Query
Response