सम्मेलन में दिन का श्लोक

यह पृष्ठ बताता है कि verse-of-the-day डेटासेट से दिन का श्लोक कैसे चुनें, ताकि आप इसे किसी भी भाषा में लागू कर सकें और हर दूसरे कार्यान्वयन के समान श्लोक प्राप्त कर सकें।

यह API स्थिर फ़ाइलों से बना है, इसलिए यह आपके लिए कोई श्लोक नहीं चुनता। यह एक साझा डिफ़ॉल्ट नियम है: इसका पालन करने वाले ऐप्स एक ही दिन एक ही श्लोक दिखाते हैं। ऐप्स अलग-अलग श्लोक चुनने के लिए स्वतंत्र हैं, और सीड उन्हें समान गारंटी बनाए रखते हुए ऐसा करने का एक आसान तरीका प्रदान करता है।

गारंटी

• निश्चित। एक ही तिथि (और सीड) हर डिवाइस और हर कार्यान्वयन में हमेशा एक ही श्लोक देती है।
• एक वर्ष में कोई दोहराव नहीं होता। प्रत्येक वर्ष के लिए छंदों का क्रम अलग-अलग होता है, और वर्ष के दिन इसी क्रम में आगे बढ़ते हैं। डेटासेट में उपयोग में आने वाले प्रत्येक दिन के लिए कम से कम 366 छंद होते हैं, इसलिए एक ही कैलेंडर वर्ष में कोई भी छंद दो बार नहीं आता।
• छुट्टियाँ। ईसाई त्योहारों (जैसे क्रिसमस या पुनरुत्थान रविवार) पर, उस दिन का श्लोक त्योहार से संबंधित श्लोकों में से एक होता है। एक त्योहार के लिए निर्धारित श्लोक एक वर्ष में एक बार आते हैं, इसलिए हर साल एक नया श्लोक होता है जब तक कि उसके सभी श्लोक उपयोग में न आ जाएँ। कई दिनों तक चलने वाले त्योहारों (जैसे पुनरुत्थान रविवार के बाद के तीन दिन) के लिए प्रत्येक दिन एक अलग श्लोक होता है। त्योहारों से संबंधित श्लोक अन्य दिनों में उपयोग नहीं किए जाते हैं।
• हर साल एक नया क्रम निर्धारित होता है। एक बार सभी श्लोकों का उपयोग हो जाने के बाद क्रम दोहराया नहीं जाता। चूंकि प्रत्येक वर्ष को अलग-अलग फेरबदल किया जाता है, इसलिए कभी-कभी एक ही श्लोक 31 दिसंबर और फिर 1 जनवरी को दिखाई दे सकता है (लगभग 650 नववर्षों में से 1 बार)।
• स्थिर इतिहास। डेटासेट केवल उन वर्षों के श्लोकों को जोड़ता या हटाता है जो अभी शुरू नहीं हुए हैं (देखें addedIn और removedIn ), इसलिए जो तिथि बीत चुकी है उसके लिए दिन का श्लोक कभी नहीं बदलता।
• सूची के क्रम से स्वतंत्र। वर्ष के क्रम में प्रत्येक श्लोक का स्थान उसके अपने संदर्भ से आता है, इसलिए सूची का क्रम मायने नहीं रखता।

इनपुट

एल्गोरिदम

चरण 1: वर्ष और वर्ष का दिन ज्ञात कीजिए।

तारीख का वर्ष, महीना और दिन लें, और उस तारीख का वर्ष का दिन 0 से गिनना शुरू करें: 1 जनवरी दिन 0 है, 31 दिसंबर दिन 364 है (या लीप वर्ष में दिन 365)।

तिथियों में ग्रेगोरियन कैलेंडर का उपयोग किया जाता है: एक वर्ष लीप वर्ष कहलाता है यदि वह 4 से विभाज्य हो, सिवाय उन वर्षों के जो 100 से विभाज्य हों लेकिन 400 से विभाज्य न हों (2000 एक लीप वर्ष है, 1900 नहीं है)।

चरण 2: उपयोग में आने वाले श्लोकों को सुरक्षित रखें

उस वर्ष में उपयोग में आने वाले श्लोकों को संभाल कर रखें:

• addedIn अनुपस्थित (या शून्य) है, या addedIn <= year , और
• removedIn अनुपस्थित (या शून्य) है, या year < removedIn ।

चरण 3: चुनने के लिए श्लोकों का चयन करें

चरण 4 के लिए चुने जाने वाले श्लोक, एक मुख्य उपसर्ग और चरण 7 के लिए एक स्थान चुनें:

1. एक श्रेणी दी गई है। उन श्लोकों को प्रयोग में रखें जिनमें categories उस श्रेणी में आता है। उपसर्ग {seed}|{year} है और स्थान वर्ष का दिन है।
2. कोई श्रेणी नहीं दी गई है, और यह तिथि अवकाश का दिन है। यदि holidays में किसी अवकाश के साथ उस तिथि का month और day आता है, या उसके dates में तिथि सूचीबद्ध है (जिसे YYYY-MM-DD के रूप में लिखा गया है, जिसमें चार अंकों का वर्ष है), तो तिथि अवकाश का दिन मानी जाएगी। यदि एक से अधिक अवकाश मेल खाते हैं, तो सूची में पहले वाले का उपयोग करें (डेटासेट में एक ही तिथि पर कभी भी दो अवकाश नहीं होते हैं)। उन छंदों को उपयोग में रखें जिनके categories में अवकाश का id शामिल है। यदि कोई हैं, तो उपसर्ग {seed}|{id} (उदाहरण के लिए |christmas ) है और स्थिति year × k + i है, जहाँ k वर्ष में अवकाश मनाए जाने वाले दिनों की संख्या है ( month और day वाले अवकाश के लिए 1; अन्यथा तिथि के वर्ष में उसके dates की संख्या) और i उन दिनों की संख्या है जो तिथि से पहले आते हैं। वर्ष में एक दिन मनाए जाने वाले अवकाश के लिए, स्थिति केवल वर्ष है। यदि कोई नहीं है, तो 3 से जारी रखें।
3. अन्यथा। उन श्लोकों को प्रयोग में रखें जिनके categories में holidays में किसी भी छुट्टी का id शामिल नहीं है। उपसर्ग {seed}|{year} है और स्थिति वर्ष का दिन है।

seed सीड है (डिफ़ॉल्ट रूप से खाली स्ट्रिंग), और year चरण 1 से वर्ष है जो दशमलव में बिना अग्रणी शून्य के है (जैसे 2026 , 1 )।

यदि कोई श्लोक शेष न रहे, तो उस दिन का कोई श्लोक नहीं होगा।

जिन छुट्टियों की तारीखें हर साल बदलती हैं, उनमें केवल पहले से तय की गई तारीखें ही दी गई हैं (वर्तमान में 2026 से 2125 तक), इसलिए बाकी वर्षों में वे सामान्य दिन होंगे। कृपया तारीखों की गणना स्वयं न करें।

चरण 4: प्रत्येक श्लोक की कुंजी बनाएं

बचे हुए प्रत्येक छंद के लिए, इस स्ट्रिंग का निर्माण करें:

{prefix}|{book} {chapter}:{verse}

• prefix चरण 3 का उपसर्ग है।
• book श्लोक का book है जैसा कि डेटासेट में दिखाई देता है (एक अपरकेस यूएसएफएम पुस्तक आईडी जैसे JHN या 1JN )।
• chapter और verse दशमलव में बिना अग्रणी शून्य के हैं।
• endVerse कुंजी का हिस्सा नहीं है। किसी अंश की पहचान उसके पहले श्लोक से होती है।

उदाहरण के लिए, डिफ़ॉल्ट सीड के साथ 2026 में एक सामान्य दिन पर जॉन 3:16 के लिए कुंजी |2026|JHN 3:16 है, और क्रिसमस पर ल्यूक 2:7 के लिए कुंजी |christmas|LUK 2:7 है।

चरण 5: प्रत्येक कुंजी को हैश करें

कुंजी के UTF-8 बाइट्स को 32-बिट FNV-1a हैश के साथ हैश करें, फिर परिणाम को MurmurHash3 fmix32 फ़ाइनलाइज़र के साथ मिक्स करें। सभी अंकगणितीय गणनाएँ अहस्ताक्षरित 32-बिट पूर्णांकों पर आधारित हैं, इसलिए गुणनफल घूम कर वापस आ जाते हैं (उन्हें मॉड्यूलो 2³² में लिया जाता है) और दाएँ शिफ्ट तार्किक होते हैं (वे शून्य को शिफ्ट करते हैं)।

hash = 0x811C9DC5
for each byte b in UTF-8(key):
    hash = hash XOR b
    hash = (hash * 0x01000193) mod 2^32

hash = hash XOR (hash >> 16)
hash = (hash * 0x85EBCA6B) mod 2^32
hash = hash XOR (hash >> 13)
hash = (hash * 0xC2B2AE35) mod 2^32
hash = hash XOR (hash >> 16)

इसका परिणाम श्लोक की सॉर्ट कुंजी है, जो 0 से लेकर 4,294,967,295 तक की एक संख्या है।

चरण 6: श्लोकों को क्रमबद्ध करें

श्लोकों को उनकी सॉर्ट कुंजी के अनुसार क्रमबद्ध करें, सबसे छोटा पहले, कुंजियों की तुलना अचिह्नित संख्याओं के रूप में करें।

यदि दो छंदों की सॉर्ट कुंजी समान हो (जो कि बहुत दुर्लभ है), तो चरण 4 से प्राप्त कुंजी स्ट्रिंग को क्रम (अक्षर कोड) में पहले रखें। सभी कुंजी स्ट्रिंग एक ही उपसर्ग से शुरू होती हैं, इसलिए उनमें केवल आगे आने वाले ASCII संदर्भ का अंतर होता है।

चरण 7: श्लोक चुनें

दिन का श्लोक क्रमबद्ध सूची में (0 से गिनते हुए) p mod n स्थान पर स्थित श्लोक है, जहाँ p तीसरे चरण का स्थान है (वर्ष का दिन, या छुट्टी के दिन year × k + i ) और n क्रमबद्ध सूची में श्लोकों की संख्या है। mod का परिणाम कभी ऋणात्मक नहीं होता (ऋणात्मक वर्ष के लिए, n तब तक जोड़ें जब तक कि यह ऋणात्मक न हो जाए)।

सामान्य दिनों में, पूरे डेटासेट में कम से कम 366 श्लोक होते हैं, इसलिए day mod n अर्थ केवल day होता है। mod का महत्व तब होता है जब आप किसी श्रेणी या अपनी बनाई सूची से ऐसे श्लोक चुनते हैं जिनमें वर्ष के दिनों की संख्या से कम श्लोक हों, क्योंकि ऐसे मामलों में वर्ष के भीतर श्लोक दोहराए जाते हैं। किसी त्योहार के दिन, स्थिति उस त्योहार के एक वर्ष के श्लोकों (और कई दिनों तक चलने वाले त्योहार के लिए एक दिन के) को एक बार में दर्शाती है।

छद्म कोड

function verseOfTheDay(verses, holidays, date, seed = "", category = null):
    year = date.year
    day = dayOfYear(date)                 // 0 for January 1st
    inUse = [v for v in verses
             if (v.addedIn == null or v.addedIn <= year)
             and (v.removedIn == null or year < v.removedIn)]

    if category != null:
        return pick([v for v in inUse if category in v.categories], seed + "|" + year, day)

    holiday = first h in holidays where (h.month == date.month and h.day == date.day)
                                     or (h.dates contains format(date, "YYYY-MM-DD"))
    if holiday != null:
        holidayVerses = [v for v in inUse if holiday.id in v.categories]
        if holidayVerses is not empty:
            if holiday.dates == null:
                position = year
            else:
                datesInYear = [d for d in holiday.dates if d starts with year + "-"]
                position = year * length(datesInYear) + count of d in datesInYear where d < date
            return pick(holidayVerses, seed + "|" + holiday.id, position)

    holidayIds = [h.id for h in holidays]
    return pick([v for v in inUse if no category of v is in holidayIds], seed + "|" + year, day)

function pick(candidates, prefix, position):
    if candidates is empty: return null
    keyed = [(hash(key), key, v) for v in candidates
             where key = prefix + "|" + v.book + " " + v.chapter + ":" + v.verse]
    sort keyed by (hash, key)             // hash as an unsigned number, key in ordinal order
    return keyed[position mod length(keyed)].verse    // a mod that is never negative

साल की हर सामान्य तारीख के लिए एक ही क्रमबद्ध सूची का उपयोग किया जाता है, इसलिए यदि आप कई तारीखों के लिए श्लोक चुनते हैं, तो उन्हें साल में एक बार क्रमबद्ध करें और उसका पुनः उपयोग करें।

बीज

सीड हर श्लोक की कुंजी को बदल देता है, जिससे समान गारंटी (एक वर्ष में कोई दोहराव नहीं, हर साल एक नया क्रम, स्थिर इतिहास) के साथ पूरी तरह से अलग क्रम मिलता है। यदि आप चाहते हैं कि आपके ऐप का अपना दैनिक श्लोक हो, न कि साझा श्लोक, तो आप अपने ऐप के नाम जैसा कोई सीड इस्तेमाल कर सकते हैं। यदि आप चाहते हैं कि सभी ऐप की तरह ही एक ही श्लोक प्रदर्शित हो, तो इसे खाली छोड़ दें।

सामान्य गलतियां

• साइन्ड पूर्णांक। जिन भाषाओं में अनसाइन्ड 32-बिट पूर्णांक नहीं होते (जैसे जावा, कोटलिन, जावास्क्रिप्ट), उनमें अंकगणित साइन्ड 32-बिट पूर्णांकों पर करें और लॉजिकल राइट शिफ्ट ( >>> ) का उपयोग करें, फिर तुलना करने से पहले परिणाम को अनसाइन्ड मान (जैसे जावास्क्रिप्ट में hash.toLong() and 0xFFFFFFFF या hash >>> 0 ) में परिवर्तित करें। जावास्क्रिप्ट में, गुणा के लिए Math.imul उपयोग करें; * सटीकता कम हो जाती है।
• बाइट्स के बजाय वर्णों को हैश करना। कुंजी के UTF-8 बाइट्स को हैश करें, न कि उसके UTF-16 कोड यूनिट्स या यूनिकोड कोड पॉइंट्स को। यह केवल गैर-ASCII वर्णों वाले सीड्स के लिए महत्वपूर्ण है, लेकिन वे स्वीकार्य हैं।
• आज के लिए UTC का उपयोग किया जा रहा है। उपयोगकर्ता के स्थानीय समय के अनुसार मध्यरात्रि को दिन का श्लोक बदल जाता है। UTC में तिथि का उपयोग करने पर अधिकांश समय क्षेत्रों में दिन के कुछ भाग के लिए पिछले या अगले दिन का श्लोक प्रदर्शित होता है।
• वर्ष के दिनों की गणना 1 से की जाती है। 1 जनवरी को दिन 0 माना जाता है।
• छुट्टियों की तारीखों की गणना। डेटासेट में सूचीबद्ध dates का उपयोग करें। विभिन्न चर्च और कैलेंडर ईस्टर की गणना अलग-अलग तरीके से करते हैं, और डेटासेट में केवल पहले से गणना की गई तारीखें ही सूचीबद्ध हैं।
• छुट्टियों को छोड़ देने पर। holidays के बिना, छुट्टियों से संबंधित छंदों को सामान्य छंदों की तरह माना जाता है, जिससे हर सामान्य दिन का छंद भी बदल जाता है।
• हटाए गए छंदों को छोड़ दिया गया है। जिन छंदों में वर्ष removedIn लिखा है, वे अभी भी डेटासेट में मौजूद हैं क्योंकि पिछले वर्षों के लिए उनकी आवश्यकता है। चरण 2 का उपयोग करके उन्हें फ़िल्टर करें; सूची डाउनलोड करते समय उन्हें न हटाएं।

परीक्षण वैक्टर

किसी कार्यान्वयन की जांच करने के लिए इन मानों का उपयोग करें।

हैश

वर्ष के दिन

चुनिंदा चुनिंदा चीज़ें

इनमें सोलह छंदों की इस सूची का उपयोग किया गया है, जिनमें से आठ त्योहारों के लिए हैं:

[
    { "book": "GEN", "chapter": 1, "verse": 1, "categories": ["praise"] },
    {
        "book": "PSA",
        "chapter": 23,
        "verse": 1,
        "categories": ["comfort", "provision"]
    },
    {
        "book": "PRO",
        "chapter": 3,
        "verse": 5,
        "endVerse": 6,
        "categories": ["faith", "guidance"]
    },
    {
        "book": "ISA",
        "chapter": 40,
        "verse": 31,
        "categories": ["strength", "hope"]
    },
    {
        "book": "JHN",
        "chapter": 3,
        "verse": 16,
        "categories": ["love", "salvation"]
    },
    {
        "book": "ROM",
        "chapter": 8,
        "verse": 28,
        "categories": ["hope"],
        "removedIn": 2027
    },
    { "book": "PHP", "chapter": 4, "verse": 13, "categories": ["strength"] },
    {
        "book": "1JN",
        "chapter": 4,
        "verse": 19,
        "categories": ["love"],
        "addedIn": 2027
    },
    { "book": "LUK", "chapter": 2, "verse": 7, "categories": ["christmas"] },
    {
        "book": "LUK",
        "chapter": 2,
        "verse": 10,
        "endVerse": 11,
        "categories": ["christmas"]
    },
    {
        "book": "MAT",
        "chapter": 1,
        "verse": 23,
        "categories": ["christmas"],
        "addedIn": 2027
    },
    {
        "book": "MAT",
        "chapter": 28,
        "verse": 6,
        "categories": ["resurrection-sunday"]
    },
    {
        "book": "ACT",
        "chapter": 2,
        "verse": 24,
        "categories": ["post-resurrection-sunday"]
    },
    {
        "book": "ROM",
        "chapter": 6,
        "verse": 9,
        "categories": ["post-resurrection-sunday"]
    },
    {
        "book": "1CO",
        "chapter": 15,
        "verse": 20,
        "categories": ["post-resurrection-sunday"]
    },
    {
        "book": "1TH",
        "chapter": 4,
        "verse": 14,
        "categories": ["post-resurrection-sunday"]
    }
]

और ये छुट्टियां (क्रिसमस की पूर्व संध्या पर कोई श्लोक नहीं हैं, इसलिए यह एक सामान्य दिन है):

[
    { "id": "christmas-eve", "month": 12, "day": 24 },
    { "id": "christmas", "month": 12, "day": 25 },
    { "id": "resurrection-sunday", "dates": ["2026-04-05", "2027-03-28"] },
    {
        "id": "post-resurrection-sunday",
        "dates": [
            "2026-04-06",
            "2026-04-07",
            "2026-04-08",
            "2027-03-29",
            "2027-03-30",
            "2027-03-31"
        ]
    }
]

2026-01-01 के लिए डिफ़ॉल्ट सीड के साथ, चार छुट्टियों से संबंधित छंद और 1 जॉन 4:19 (जो अभी उपयोग में नहीं है) को छोड़ दिया गया है, इसलिए सात छंद बचे हैं। उनके सॉर्ट कुंजी के अनुसार क्रमबद्ध करने पर, वे इस प्रकार हैं:

जनवरी का पहला दिन शून्य है, इसलिए आज का वचन भजन संहिता 23:1 है। मार्च का 73वां दिन है, और 73 मॉड 7 = 3 होता है, इसलिए यह यूहन्ना 3:16 है।

क्रिसमस पर, केवल प्रचलन में रहने वाले क्रिसमस के श्लोक ही शेष रहते हैं। 2027 में तीन श्लोक हैं, जिन्हें उनके सॉर्ट कीज़ के अनुसार क्रमबद्ध किया गया है:

2027 मॉड 3 = 2, इसलिए क्रिसमस 2027 के दिन का श्लोक लूका 2:7 है। 2026 में, मत्ती 1:23 अभी उपयोग में नहीं है, इसलिए केवल दो ही हैं, और 2026 मॉड 2 = 0 से लूका 2:10-11 प्राप्त होता है।

ईस्टर संडे के बाद की छुट्टी तीन दिनों तक चलती है। इसके चार श्लोक, क्रमानुसार इस प्रकार हैं:

2026 में इसे तीन दिनों तक मनाया जाता है, इसलिए k = 3, और 6, 7 और 8 अप्रैल की स्थितियाँ 2026 × 3 + 0 = 6078, 6079 और 6080 हैं। 6078 मॉड 4 = 2, 6079 मॉड 4 = 3, और 6080 मॉड 4 = 0 से 1 कुरिन्थियों 15:20, प्रेरितों के कार्य 2:24 और 1 थिस्सलनीकियों 4:14 प्राप्त होते हैं। 2027 में स्थितियाँ 6081 से जारी रहती हैं, इसलिए अगला पद रोमियों 6:9 है।

2028-04-16 पुनरुत्थान रविवार है, लेकिन यह इस सूची के dates में नहीं है, इसलिए यह एक साधारण दिन है।

डेटासेट से चयनित

डेटासेट में शुरू हो चुके वर्ष के श्लोकों में कभी बदलाव नहीं होता, इसलिए दिन के ये 2026 श्लोक अपरिवर्तित रहते हैं:

कार्यान्वयन

ये कार्यान्वयन परंपरा का पालन करते हैं, और इनके परीक्षण इस पृष्ठ पर दिए गए मानों की जाँच करते हैं:

• जावास्क्रिप्ट/टाइपस्क्रिप्ट: free-use-bible-api पैकेज में pickVerseOfTheDay() और FreeUseBibleApi.getVerseOfTheDay() ( स्रोत )।
• कोटलिन: कोटलिन एसडीके में pickVerseOfTheDay() और FreeUseBibleApi.getVerseOfTheDay() ( स्रोत )।
• स्विफ्ट: स्विफ्ट एसडीके में pickVerseOfTheDay(_:date:seed:category:holidays:) और FreeUseBibleAPI.getVerseOfTheDay(date:seed:category:dataset:endpoint:) ( स्रोत )।
• एमसीपी सर्वर का getVerseOfTheDay उपकरण ( स्रोत )।
• getVerseOfTheDay() में @helloao/tools ( स्रोत ), जो पैकेज में निर्मित सूची का उपयोग करता है।