ForHosting KIT · أدوات المطورين

حاسبة التغير النسبي للبيانات المدرسية

تقارن حاسبة التغير النسبي المدرسي قيمة أصلية بقيمة لاحقة، ثم تعرض الفرق كمقدار وكنسبة مئوية ذات إشارة.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

تدل النتيجة الموجبة على ارتفاع، والسالبة على انخفاض، والصفر على عدم حدوث تغير. يمكنكم استخدامها لأعداد المسجلين والحضور ومتوسطات الاختبارات والقراءة والمشاركة، أو لأي قياس مدرسي غير سالب له نقطة بداية صالحة. وتتضمن النتيجة شرحًا واضحًا يساعدكم على ربط العملية الحسابية بمعناها.

أدخلوا القيمة الأصلية والجديدة بالترتيب الصحيح

يصف التغير النسبي دائمًا الانتقال من نقطة بداية إلى نقطة لاحقة. أدخلوا القياس الأسبق بوصفه القيمة الأصلية، والقياس اللاحق بوصفه القيمة الجديدة. فإذا سجلت المكتبة 800 إعارة في الشهر الماضي و920 في هذا الشهر، تكون 800 هي القيمة الأصلية و920 هي الجديدة. يؤدي عكسهما إلى الإجابة عن سؤال مختلف لأن المقام يتغير. يجب أن يمثل الرقمان الكمية والوحدة والفئة السكانية والمدة نفسها. فلا تقارنوا حضورًا أسبوعيًا بحضور شهري، ولا عدد طلاب صف واحد بإجمالي المدرسة، قبل توحيد أساس القياس. تقبل الحاسبة كميات مدرسية غير سالبة، لكن يجب أن تكون القيمة الأصلية أكبر من الصفر. لا يمكن حساب التغير النسبي المعتاد عندما يكون خط الأساس صفرًا، لأن ذلك يتطلب القسمة على صفر. في هذه الحالة، اذكروا مقدار الزيادة العددي أو استخدموا أسلوب مقارنة آخر بدلًا من عرض نسبة مضللة.

افهموا صيغة التغير النسبي ذي الإشارة

يطرح الحساب أولًا القيمة الأصلية من القيمة الجديدة، ثم يقسم الفرق على القيمة الأصلية ويضرب الناتج في 100. والصيغة هي (القيمة الجديدة ناقص القيمة الأصلية) مقسومة على القيمة الأصلية، ثم مضروبة في 100. إذا ارتفع متوسط دقائق القراءة من 40 إلى 50، فالفرق 10؛ وقسمة 10 على 40 تساوي 0.25، ولذلك يكون التغير +25 بالمئة. وإذا انخفض المتوسط من 50 إلى 40، فالفرق -10 والنتيجة -20 بالمئة. ليست النتيجتان متعاكستين لأن كل مقارنة تستخدم خط أساس مختلفًا. توضح الإشارة الاتجاه: الموجب زيادة، والسالب انخفاض، والصفر عدم تغير. تحتفظ الاستجابة بالإشارة في percentage_change، وتعرض أيضًا increase أو decrease أو no_change. يطبق التقريب على الفرق والنسبة المعروضين فقط، وفق عدد المنازل العشرية الذي تحددونه، ولذلك تعطي المدخلات نفسها نتائج ثابتة.

اشرحوا النتيجة بوضوح في الواجبات المدرسية

ينبغي أن يذكر التفسير الكامل الكمية والفترتين واتجاه التغير ومقداره. يمكنكم مثلًا كتابة: «ارتفع عدد الطلاب المشاركين في الدروس المساندة من 48 في سبتمبر إلى 60 في أكتوبر، أي بزيادة قدرها 25 بالمئة». هذه العبارة أوضح من كتابة «25 بالمئة» وحدها، لأن النسبة المجردة لا تبين ما الذي تغير ولا اتجاهه. احتفظوا بالإشارة عند تخزين البيانات أو متابعة الحساب، فهي تسهل فرز الانخفاضات وتمثيلها وتجميعها. وفي النص، يكون استخدام المقدار المطلق مع كلمتي ارتفع أو انخفض أكثر سلاسة. تذكروا كذلك أن التغير النسبي لا يساوي التغير بالنقاط المئوية. فإذا ارتفع معدل الحضور من 80 بالمئة إلى 90 بالمئة، فالفرق 10 نقاط مئوية، لكن التغير النسبي هو 12.5 بالمئة. تحققوا من المقياس المطلوب في السؤال. تعمل العملية الحتمية نفسها في المتصفح، وتبلغ تكلفة طلب API آلي واحد $0.002.

حالات الاستخدام

مقارنة أعداد المسجلين

قيسوا مقدار ارتفاع التسجيل أو انخفاضه بين عامين دراسيين باستخدام العدد السابق بوصفه خط الأساس.

متابعة المشاركة الصفية

قارنوا الواجبات المكتملة أو دقائق القراءة أو حضور الأندية خلال فترتين متكافئتين.

شرح اتجاه في جدول بيانات

احصلوا على النتيجة ذات الإشارة والاتجاه اللازمين لصياغة جملة واضحة عن البيانات المدرسية.

الأسئلة الشائعة

ما الصيغة التي تستخدمها الحاسبة؟

تطبق ((القيمة الجديدة - القيمة الأصلية) / القيمة الأصلية) × 100، وتعيد النتيجة مع إشارتها.

لماذا يجب أن تتجاوز القيمة الأصلية الصفر؟

لأنها المقام. يتطلب خط الأساس الصفري القسمة على صفر، ولذلك لا يكون التغير النسبي المعتاد معرّفًا.

ماذا تعني النسبة السالبة؟

تعني أن القيمة الجديدة أقل من الأصلية، ويصنف حقل الاتجاه النتيجة على أنها انخفاض.

هل التغير النسبي هو نفسه التغير بالنقاط المئوية؟

لا. الأول نسبي إلى القيمة الأصلية، أما الثاني فهو الفرق المباشر بين نسبتين مئويتين.

هل يمكنكم اختيار دقة التقريب؟

نعم. اضبطوا decimals على عدد صحيح من 0 إلى 10؛ والقيمة الافتراضية منزلتان عشريتان.

ما التكلفة؟

الحساب في المتصفح مجاني، ولكل طلب API سعر أساسي قدره $0.002.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/edu/percent-change-school

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/edu/percent-change-school \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"old_value":40,"new_value":50}'

const res = await fetch("https://api.kit.forhosting.com/edu/percent-change-school", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "old_value": 40,
    "new_value": 50
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/percent-change-school",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "old_value": 40,
    "new_value": 50
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/percent-change-school", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"old_value":40,"new_value":50}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"old_value":40,"new_value":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/percent-change-school", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "old_value": 40,
  "new_value": 50
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.percent_change_school",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

max_abs_value 1000000000000000

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←