اگر با دیتابیس کار می کنید حتما به گزارش هایی برخوردید که لازم باشه از تاریخ شمسی استفاده کنید. همونطور که می دونید توابع شمسی در دیتابیس ها (دیتابیس مد نظرمون در این مقاله MS SQL!) وجود ندارند البته با روش های مختلف می شود این تبدیل رو انجام داد هر چند که در ادامه مختصری درباره هر کدام ازاین روش ها توضیح خواهم داد ولی هدف این مقاله آموزش پیاده سازی یک User-Defined Function برای تبدیل تاریخ میلادی به شمسی و استفاده آن در SQL می باشد.
روش های دیگر کار با تاریخ شمسی
- برای تبدیل تاریخ میلادی به شمسی می تونید از تابع FORMAT استفاده کنید که با پر کردن آرگومان culture با مقدار ‘fa-ir’ این تبدیل به سادگی هر چه تمام صورت می گیرد. به طور مثال:
1234DECLARE @today DATE = GETDATE();SELECT FORMAT( @today, 'yyyy-MM-dd', 'fa-IR' ) -- ۱۴۰۰-۰۱-۰۵SELECT FORMAT( @today, 'yyyy-MMM', 'fa-IR' ) --۱۴۰۰-فروردینSELECT FORMAT( @today, 'yyyy-MM-dd-dddd', 'fa-IR' ) --۱۴۰۰-۰۱-۰۵-پنجشنبه - روش دیگر تبدیل و کار با تاریخ شمسی، استفاده از جدول DimDate است که بسیار پر کاربرد در حوزه هوش تجاری می باشد و انعطاف زیادی برای اعمال تغییرات دارد. کار با این روشساده است و تنها کافیه جدول رو با جدول های دیگر ارتباط دهید. همچنین می تونید از قابلیت های Time intelligence هم در این روش استفاده کنید البته با کمی کدنویسی و تنظیمات!
و اما نحوه نوشتن یک تابع سفارشی در MS-SQL
برای این کار لازمه Visual Studio رو نصب داشته باشید. نوشتن تابع با استفاده از زبان #C صورت می گیرد و برای تبدیل تاریخ میلادی به شمسی از System.Globalization و کلاس PersianCalendar که از پیش توسط مایکروسافت تهیه شده استفاده می کنیم (کار رو ساده کرد!).
برای شروع، یک پروژه جدید Sql Server در محیط Visual Studio درست می کنیم. برای این کار از مسیر File > New > Project پروژه SQL Server را جستجو کنید.
و پس از تعیین نام و مسیر ذخیره، پروژه را ایجاد کنید.
با راست کلیک بر روی پروژه، یک item جدید با عنوان User-Defined Function اضافه کنید.
و در نهایت آیتم زیر را به پروژه اضافه کنید. و دقت کنید نام JalaliFunction رو برای این فایل انتخاب کردم بعدا با این نام کار داریم.
با باز شدن فایل به غیر از کتابخانه ها کد زیر را خواهید دید.
|
1 2 3 4 5 6 7 8 9 |
public partial class UserDefinedFunctions { [Microsoft.SqlServer.Server.SqlFunction] public static SqlString JalaliFunction() { // Put your code here return new SqlString (string.Empty); } } |
کدر زیر رو در داخل بلاک function و جایگزین return new SqlString (string.Empty) کنید.
|
1 2 3 4 5 6 7 8 9 10 11 12 |
string result = ""; if (dt != null) { PersianCalendar objPersianCalendar = new PersianCalendar(); int year = objPersianCalendar.GetYear(dt); int month = objPersianCalendar.GetMonth(dt); int day = objPersianCalendar.GetDayOfMonth(dt); result = year.ToString().PadLeft(4, '0') + "/" + month.ToString().PadLeft(2, '0') + "/" + day.ToString().PadLeft(2, '0'); } return new SqlString(result); |
همچنین داخل function مقدار پارامتر DateTime dt رو قرار دهید و در نهایت خواهید داشت:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
using System; using System.Data; using System.Data.SqlClient; using System.Data.SqlTypes; using Microsoft.SqlServer.Server; using System.Globalization; public partial class UserDefinedFunctions { [Microsoft.SqlServer.Server.SqlFunction] public static SqlString JalaliFunction(DateTime dt) { string result = ""; if (dt != null) { PersianCalendar objPersianCalendar = new PersianCalendar(); int year = objPersianCalendar.GetYear(dt); int month = objPersianCalendar.GetMonth(dt); int day = objPersianCalendar.GetDayOfMonth(dt); result = year.ToString().PadLeft(4, '0') + "/" + month.ToString().PadLeft(2, '0') + "/" + day.ToString().PadLeft(2, '0'); } return new SqlString(result); } } |
پس از راست کلیک بر روی solution و انتخاب build کار با محیط Visual Studio تمام خواهد شد.
قبل از ایجاد تابع ساخته شده در SQL لازمه برخی تنظیمات انجام بشه که با اجرا کد زیر ( البته با داشتن دسترسی لازم) تغییرات اعمال خواهد شد. همچنین دقت کنید یک بار انجام کد اجرا بشه کافیه و نیازی نیست کد زیر رو برای پروژه های دیگه دوباره اجرا کنید.
|
1 2 3 4 5 6 7 8 9 10 |
sp_configure 'show advanced options', 1; GO RECONFIGURE; GO sp_configure 'clr enabled', 1; GO EXEC sp_configure 'clr strict security',0; GO RECONFIGURE; GO |
برای ایجاد ارتباط sql با تابع نیاز است فایل آدرس dll ایجاد شده پس از build پروژه رو در مسیر کد زیر قرار بدید و اجرا کنید.
|
1 2 |
CREATE ASSEMBLY PersianSQLFunctions FROM 'F:\datasense\2_PersianDateTimeCLR\PersianSQLFunctions\bin\Debug\PersianSQLFunctions.dll' |
|
1 2 3 4 5 6 7 8 |
USE master GO CREATE FUNCTION ToPersianDate ( @dt DateTime ) RETURNS NVARCHAR(10) AS EXTERNAL NAME PersianSQLFunctions.UserDefinedFunctions.JalaliFunction |
|
1 |
SELECT [dbo].[ToPersianDate](GETDATE()) --1400/01/05 |
۱ دیدگاه. ترک جدید
عالی هست.ممنون