ساڵنامه‌ی دیجیتاڵی كوردی

هاوکار بن بۆ ئەوەی پرۆژەی ساڵنامەی دیجیتاڵی کوردی بە زیندوویی و بەخۆڕایی بمێنێتەوە! بەخشینەکەت واته‌ پاڵپشتی پەرەپێدان و پاراستنی ئەم سەرچاوە بەنرخە بۆ کۆمەڵگای کوردیه‌. هەموو بەشدارییەک، گەورە بێت یان بچووک، جیاوازی دروست دەکات. سوپاس بۆ بەخشندەییتان!

یان بەخشین لە ڕێگەی کریپتۆ USDT-TRC20: TWtHokKWbRGG5R4BahUoggCMA8rL1TFttW

دایبەزێنە و تاقی بکەرەوە 💾 كلیك لێره‌ بكه‌.

ساڵنامەی دیجیتاڵی کوردی (KDC) زیادکراوەیەکی هەمەلایەنە و هاوڕێی به‌كارهێنه‌ره‌ و بۆ بەرنامەکانی مایکرۆسۆفت ئۆفیس داڕێژراوە. ڕێگە بە بەکارهێنەران دەدات بە شێوەیەکی بێ کێشە ڕێكه‌وتەکان لە نێوان ساڵنامەی زاینی، هیجری، ئوم القورا، و کوردیدا دابنێن و بیگۆڕن. زیادکراوەکە پشتگیری لە بەرنامە جیاوازەکانی ئۆفیس دەکات، لەوانە وۆرد، ئێکسڵ، پاوەرپۆینت، ئاوتلۆک، COM Library بۆ ئه‌كسس، ڤیزیۆ و مایكرۆسۆفت پڕۆجێكت، دڵنیابوون لە ڕاستی و وردبینی لە دانان لەگەڵ ڕێكه‌وتەکان لە هه‌ر دۆكومێنتێكدا.

بینەری چاوپێکەوتنەکان بن دەربارەی ساڵنامەی دیجیتاڵی کوردی له‌:

• Kurdsat News
• GK Television (06:12)

زاراوە پشتگیری کراوەکان

• Kurdish (Central) - سۆرانی
• Kurdish (Northern) - کرمانجی

جۆری ساڵنامه‌كان

ساڵنامە سه‌ره‌كیه‌كان

- KDC ئەم ساڵنامە سه‌ره‌كیانه‌ بە زمانی کوردی و عەرەبی و ئینگلیزی ده‌ناسێته‌وه‌:

- Gregorian
- Hijri
- Umm al-Qura

گۆڕینی ساڵنامه‌ یه‌ پێچه‌وانه‌وه‌

• ئەم ساڵنامانە بۆ گۆڕینی پێچەوانە بەکاردەهێنرێن لەسەر بنەمای ساڵنامەی سەرەکی هەڵبژێردراو:

- Gregorian (English)
- Gregorian (Arabic)
- Gregorian (Kurdish Central)
- Gregorian (Kurdish Northern)
- Hijri (English)
- Hijri (Arabic)
- Hijri (Kurdish Central)
- Hijri (Kurdish Northern)
- Umm al-Qura (English)
- Umm al-Qura (Arabic)
- Umm al-Qura (Kurdish Central)
- Umm al-Qura (Kurdish Northern)
- Kurdish (Central)
- Kurdish (Northern)

فۆرماتەکانی ڕێكه‌وتی پشتگیریکراو

• dddd, dd MMMM, yyyy
• dddd, dd/MM/yyyy
• dd MMMM, yyyy
• MMMM dd, yyyy
• dd/MM/yyyy
• MM/dd/yyyy
• yyyy/MM/dd
• MMMM yyyy
• MM/yyyy
• MMMM
• yyyy

ستایلی ئایكۆنه‌كان

• ڕووناك
• تاریك

تایبتمەندیەکان

KD Calendar Tab

Settings

• Settings
  • دیالۆگی ڕێکخستنەکان بکەرەوە بۆ ڕێکخستنی ڕێکخستنەکانی ساڵنامە، وەک هەڵبژاردنی زاراوە، تەوەرەی ئایکۆن، زیادکردنی ناوی ساڵنامەی پاشگر، و چالاککردن/ناچالاککردنی نوێکردنەوەی ڕێكه‌وتی ئۆتۆماتیکی لە کاتی كردنه‌وه‌ی دۆكیومێنت.

Update Dates

• Update Dates
  • هەموو نووسراوەکانی ڕێكه‌وت لە دۆكیومێنته‌كه‌دا نوێ دەکاتەوە بۆ ئەوەی گۆڕانکارییەکانی ڕێکخستن یان فۆرماتەکانی ساڵنامە نوێ بكاته‌وه‌.

Converter (Selected Date)

Calendar

• Calendar
  • جۆری سیستەمی ساڵنامە هەڵبژێرە (بۆ نموونە گریگۆری، هیجری، ئوم القورە).

Date Conversion

• From Source Date Format

  • فۆرماتەکەی ڕێكه‌وتی سه‌رچاوه‌ هەڵبژێرە.

• Switch

  • گۆڕینی نێوان سیستەمی ساڵنامەی هەڵبژێردراو پێچەوانە بکەرەوە.

• To Target Date Format

  • فۆرماتی ئامانج هەڵبژێرە بۆ گۆڕین.

• Convert

  • ڕێكه‌وتی هەڵبژێردراو بگۆڕە بۆ ڕێكه‌وتی ساڵنامەی کوردی یان بە پێچەوانەوە.

Insert Date

Automatic Update

• Update Automatically
  • کاتێک دۆكیومێنته‌كه‌ دەکرێتەوە یان نوێ دەکرێتەوە، بە شێوەیەکی ئۆتۆماتیکی شوێنی ڕێكه‌وت نوێ دەکاتەوە.

Date Format

• Format
  • فۆرماتێکی ڕێكه‌وت هەڵبژێرە بۆ بەکارهێنان لە کاتی دانانی ڕێكه‌وتەکان بۆ ناو دۆكیومێنته‌كه‌ت.

Insert Today's Date

• Today
  • ڕێكه‌وتی ئەمڕۆ بخەرە ناو شوێنی هەڵبژێردراوەوە.

Date Picker

• Choose
  • هەڵبژاردەی ڕێكه‌وت بکەرەوە بۆ هەڵبژاردن و دانانی ڕێكه‌وتێکی دیاریکراوی کوردی بە پشتبەستن بە ساڵنامەی زاینی.

COM Library Integration

• ساڵنامەی دیجیتاڵی کوردی (KDC) پشتگیری COM Library دەکات بۆ ئاسانکاری لە بەکارهێنانی گۆڕینی ڕێكه‌وت و ژمارەی کوردی لە بەرنامە جۆراوجۆرەکانی ئۆفیس لە ڕێگەی ڤیزواڵ به‌یسك VBA. ئەم ڕێنماییە چۆنیەتی بەکارهێنانی KDC COM Library لە VBA ڕوون دەکاتەوە.

• KDC COM Library پشتگیری کۆمەڵێک ئەرک بۆ گۆڕینی ڕێكه‌وتەکان لە نێوان سیستەم و فۆرماتە جیاوازەکانی ساڵنامە و گۆڕینی ژمارەکان بۆ دەقی کوردی دەکات:

  • ToKurdish (Support both Kurdish Central and Kurdish Northern Dialects)

    • Insert the current Kurdish date into the document.
    • Syntax: ToKurdish(formatChoice, dialect, isAddSuffix) Default Dialect is Kurdish Central.
      • Parameters
        • formatChoice: The format of the output date.
        • dialect: The dialect of Kurdish to use ("ckb" for Central or "ku" for Northern).
        • isAddSuffix: A boolean value indicating whether to add suffixes to the output date.
      • Example: ToKurdish(1, "Kurdish (Central)", true) or ToKurdish(1, "Kurdish (Northern)", true)
      • Result:
        • Kurdish Central Dialect : "دووشەممە، 11 بەفرانبار، 2723ی كوردی"
        • Kurdish Northern Dialect : "Duşem, 11 Berfanbar, 2723 Kurdî"
      • Note: The function supports dates from 21/03/0001 to 31/12/9999.

  • ConvertNumberToKurdishCentralText

    • Converts a number to Kurdish Central text.
    • Syntax: ConvertNumberToKurdishCentralText(Number)
      • Parameters
        • Number: The number to convert to Kurdish text.
      • Example: ConvertNumberToKurdishCentralText(123456789)
      • Result: "سەد و بیست و سێ ملیۆن و چوار سەد و پەنجا و شەش هەزار و حەوت سه‌د و هه‌شتاو نۆ"
      • Note: The function supports numbers up to 999,999,999,999,999,999.

  • ConvertNumberToKurdishNorthernText

    • Converts a number to Kurdish Northern text.
    • Syntax: ConvertNumberToKurdishNorthernText(Number)
      • Parameters
        • Number: The number to convert to Kurdish text.
      • Example: ConvertNumberToKurdishNorthernText(123456789)
      • Result: "sed û bîst û sê milyon û çar sed û pêncî û şeş hezar û heft sed û heştê û neh"
      • Note: The function supports numbers up to 999,999,999,999,999,999.

  • ConvertDateBasedOnUserSelection (Support both Kurdish Central and Kurdish Northern Dialects)

    • Converts a date between different calendar systems and formats based on user selection.
    • Syntax: ConvertDateBasedOnUserSelection(Date, fromCalendar, toCalendar, fromFormat, toFormat, targetDialect, isAddSuffix) Default Dialect is Kurdish Central.
    • Parameters
      • Date: The date to convert.
      • fromCalendar: The calendar system of the input date.
      • toCalendar: The calendar system of the output date.
      • fromFormat: The format of the input date.
      • toFormat: The format of the output date.
      • targetDialect: The dialect of Kurdish to use ("ckb" for Central or "ku" for Northern).
      • isAddSuffix: A boolean value indicating whether to add suffixes to the output date.
    • Example: ConvertDateBasedOnUserSelection("01/01/2024", "Gregorian", "Kurdish", "dd/MM/yyyy", "dddd, dd MMMM, yyyy", "Kurdish (Central)", true) or ConvertDateBasedOnUserSelection("01/01/2024", "Gregorian", "Kurdish", "dd/MM/yyyy", "dddd, dd MMMM, yyyy", "Kurdish (Northern)", true)
    • Result:
      • Kurdish Central Dialect : "دووشەممە، 11 بەفرانبار، 2723ی كوردی"
      • Kurdish Northern Dialect : "Duşem, 11 Berfanbar, 2723 Kurdî"
    • Note: The function supports dates from 0002-01-01 to 9999-12-31.

پێش مه‌رجه‌كان

• دڵنیابە کە KDC COM Libraryـت لەسەر سیستەمەکەت داناوە و تۆمار کراوە.
• Reference زیاد بکە بۆ KDC COM Library لە ئدیته‌ری VBA ـەکەتدا.

زیادکردنی سه‌رچاوه‌ بۆ KDC COM Library

1. Open your VBA editor in Excel (or any other Office application).
2. Go to Tools > References.
3. Check the box for Kurdish Digital Calendar Library.

KDC COM Library ئەرکەکان لە نموونەی کۆدی VBA

' Declare a reference to the .NET class
Dim kdcService As Object

' Insert Now Kurdish Date
Function ToKurdish(formatChoice As Integer, dialect As String, isAddSuffix As Boolean) As String
    On Error GoTo ErrorHandler
    Set kdcService = CreateObject("KDCLibrary.KDCServiceImplementation")
    ToKurdish = kdcService.ToKurdish(formatChoice, dialect, isAddSuffix)
    Exit Function

ErrorHandler:
    ToKurdish = "Error: " & Err.Description
End Function

' Convert Date Based On User Selection
Function ConvertDateBasedOnUserSelection(selectedText As String, isReverse As Boolean, targetDialect As String, fromFormat As String, toFormat As String, targetCalendar As String, isAddSuffix As Boolean) As String
    On Error GoTo ErrorHandler
    Set kdcService = CreateObject("KDCLibrary.KDCServiceImplementation")
    ConvertDateBasedOnUserSelection = kdcService.ConvertDateBasedOnUserSelection(selectedText, isReverse, targetDialect, fromFormat, toFormat, targetCalendar, isAddSuffix)
    Exit Function

ErrorHandler:
    ConvertDateBasedOnUserSelection = "Error: " & Err.Description
End Function

' Convert Number To Kurdish Central Text
Function ConvertNumberToKurdishCentralText(number As Long) As String
    On Error GoTo ErrorHandler
    Set kdcService = CreateObject("KDCLibrary.KDCServiceImplementation")
    ConvertNumberToKurdishCentralText = kdcService.ConvertNumberToKurdishCentralText(number)
    Exit Function

ErrorHandler:
    ConvertNumberToKurdishCentralText = "Error: " & Err.Description
End Function

' Convert Number To Kurdish Northern Text
Function ConvertNumberToKurdishNorthernText(number As Long) As String
    On Error GoTo ErrorHandler
    Set kdcService = CreateObject("KDCLibrary.KDCServiceImplementation")
    ConvertNumberToKurdishNorthernText = kdcService.ConvertNumberToKurdishNorthernText(number)
    Exit Function

ErrorHandler:
    ConvertNumberToKurdishNorthernText = "Error: " & Err.Description
End Function

' Test the functions with KDC Object
Sub ExampleUsage()
    Dim number As Long
    number = 12345
    MsgBox "Kurdish Text (Central): " & ConvertNumberToKurdishCentralText(number)
    MsgBox "Kurdish Text (Northern): " & ConvertNumberToKurdishNorthernText(number)
    
    Dim kurdishDate As String
    kurdishDate = ToKurdish(1, "Kurdish (Central)", True)
    MsgBox "Kurdish Date: " & kurdishDate
    
    Dim convertedDate As String
    convertedDate = ConvertDateBasedOnUserSelection("01/01/2024", False, "Kurdish (Central)", "dd/MM/yyyy", "dddd, dd MMMM, yyyy", "Gregorian", True)
    MsgBox "Converted Date: " & convertedDate
End Sub

' Test the functions with KDC Library Reference
Sub ExampleUsage2()
    Dim kurdishDate As String
    Dim number As Long
    Dim convertedDate As String
    Dim kdcService As New KDC_Library.KDCServiceImplementation
        
    number = 12345
    kurdishDate = kdcService.ToKurdish(1, "Kurdish (Central)", True)
    convertedDate = kdcService.ConvertDateBasedOnUserSelection("01/01/2024", False, "Kurdish (Central)", "dd/MM/yyyy", "dddd, dd MMMM, yyyy", "Gregorian", True)

    MsgBox "Kurdish Text (Central): " & kdcService.ConvertNumberToKurdishCentralText(number)
    MsgBox "Kurdish Text (Northern): " & kdcService.ConvertNumberToKurdishNorthernText(number)
    MsgBox "Kurdish Date: " & kurdishDate
    MsgBox "Converted Date: " & convertedDate
End Sub

User-Defined Functions in MS Excel

• Call custom functions like ConvertNumberToKurdishText and ConvertDateToKurdish directly from Excel cells.

  • ConvertNumberToKurdishText (Support both Kurdish Central and Kurdish Northern Dialects)

    • Converts a number to Kurdish text.
    • Syntax: ConvertNumberToKurdishText(Number, langcode as Optional) Default Dialect is Kurdish Central.
      • Parameters
        • Number: The number to convert to Kurdish text.
        • langcode (optional): The dialect of Kurdish to use ("ckb" for Central or "ku" for Northern).
    • Example: ConvertNumberToKurdishText(123456789) or ConvertNumberToKurdishText(123456789, "ku") or ConvertNumberToKurdishText(123456789, "ckb")
    • Result:
      • Kurdish Central Dialect : "سەد و بیست و سێ ملیۆن و چوار سەد و پەنجا و شەش هەزار و حەوت سه‌د و هه‌شتاو نۆ"
      • Kurdish Northern Dialect : "sed û bîst û sê milyon û çar sed û pêncî û şeş hezar û heft sed û heştê û neh"
    • Note: The function supports numbers up to 999,999,999,999,999,999.

  • ConvertDateToKurdish (Support both Kurdish Central and Kurdish Northern Dialects)

    • Converts a date to the Kurdish calendar.
    • Syntax: ConvertDateToKurdish(Date, targetDialect as Optional, fromFormat as Optional, toFormat as Optional, targetCalendar as Optional, isAddSuffix as Optional) Default Dialect is Kurdish Central.
      • Parameters
        • Date: The date to convert to the Kurdish calendar.
        • targetDialect: The dialect of Kurdish to use ("ckb" for Central or "ku" for Northern).
        • fromFormat: The format of the input date.
        • toFormat: The format of the output date.
        • targetCalendar: The calendar system to use for conversion.
        • isAddSuffix (optional): A boolean value indicating whether to add suffixes to the output date.
      • Example: ConvertDateToKurdish("01/01/2024", "Kurdish (Central)", "dd/MM/yyyy", "dddd, dd MMMM, yyyy", "Gregorian", true) or ConvertDateToKurdish(01/01/2024", "Kurdish (Northern)", "dd/MM/yyyy", "dddd, dd MMMM, yyyy", "Gregorian", true) Default Dialect is Kurdish Central.
      • Result:
        • Kurdish Central Dialect : "دووشەممە، 11 بەفرانبار، 2723ی كوردی"
        • Kurdish Northern Dialect : "Duşem, 11 Berfanbar, 2723 Kurdî"
      • Note: The function supports dates from 21/03/0001 to 31/12/9999.

دامەزراندن

پێش مه‌رجه‌كان

• Microsoft Office (Word, Excel, PowerPoint, Outlook, Access, Visio, Project)
• .NET Framework 4.7.2 or higher
• Visual Studio Tools for Office (VSTO) Runtime 2010 or higher

بەکارهێنانی Installer

1. Download the latest release from the GitHub releases page.
2. Run the installer and select the components you wish to install.
3. Follow the on-screen instructions to complete the installation.

بەشداریکردن

بۆ بەشداریکردن لە پرۆژەی ساڵنامەی دیجیتاڵی کوردی:

1. Fork the repository on GitHub.
2. Create a new branch for your feature or bug fix.
3. Commit your changes and push your branch to GitHub.
4. Open a pull request with a description of your changes.

بۆ زانیاری زیاتر سەیری... ڕێنماییەکانی بەشداریکردن.

مۆڵەت

ئەم پرۆژەیە بەپێی مۆڵەتی تایبەت بۆ ساڵنامەی دیجیتاڵی کوردی (KDC) مۆڵەتی پێدراوە.

تۆ ئازادیت لە بەکارهێنانی ئەم نەرمەکاڵایە تەنها بۆ مەبەستی کەسی، پەروەردەیی، یان بازرگانی ناوخۆیی. دووبارە دابەشکردنەوە و بڵاوکردنەوە و بەکارهێنانی بازرگانی بە توندی قەدەغەیە بەبێ مۆڵەتی نووسراوی ڕاشکاوانە لەلایەن نووسەرەوە. بۆ زانیاری زیاتر، تکایە سەردانی فایلی LICENSE بکەن.

بۆ مۆڵەتەکانی دەرەوەی بازنەی ئەم مۆڵەتە، تکایە پەیوەندی بکەن بە rekbin.devs@gmail.com.

Credits

• پەرەپێدان و پاراستنی لەلایەن تیشکۆ ڕەسوڵ (ڕێکبین دیڤس).
• ئه‌لگۆریذمی ساڵنامه‌ی كوردی پشت به‌م سه‌رچاوه‌انه‌ داڕێژراوه‌:
  • ساڵنامەی ئەکادیمیای کوردی (٢٠٠٩)
  • ڕۆژژمێری کوردی له‌ ویكیپێدیا
  • ڕۆژژمێری کۆچی له‌ ویكیپێدیا
  • Salname له‌ ویكیپێدیا
  • سوپاس بۆ هەموو بەشداربووان و هاوكاران.

په‌یوه‌ندی

بۆ پرس یان پرسیار، كێشه‌یه‌ك لەسەر ساڵنامه‌ی دیجیتاڵی كوردی یان پەیوەندیمان پێوە بکەن لە rekbin.devs@gmail.com.