diff Chronosv2/source/Extensions/DateTimeExtensions.cs @ 10:443821e55f06

Initial cleaned up add from Codeplex files
author stevenh7776 stevenhollidge@hotmail.com
date Tue, 21 Feb 2012 17:25:44 +0700
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Chronosv2/source/Extensions/DateTimeExtensions.cs	Tue Feb 21 17:25:44 2012 +0700
@@ -0,0 +1,299 @@
+using System;
+using System.Globalization;
+
+namespace Chronos.Extensions
+{
+    /// <summary>
+    /// Extension methods for the DateTimeOffset data type.
+    /// </summary>
+    public static class DateTimeExtensions
+    {
+        #region · Extensions ·
+
+        /// <summary>
+        /// Calculates the age based on today.
+        /// </summary>
+        /// <param name="dateOfBirth">The date of birth.</param>
+        /// <returns>The calculated age.</returns>
+        public static int CalculateAge(this DateTime dateOfBirth)
+        {
+            return CalculateAge(dateOfBirth, DateTime.Today);
+        }
+
+        /// <summary>
+        /// Calculates the age based on a passed reference date.
+        /// </summary>
+        /// <param name="dateOfBirth">The date of birth.</param>
+        /// <param name="referenceDate">The reference date to calculate on.</param>
+        /// <returns>The calculated age.</returns>
+        public static int CalculateAge(this DateTime dateOfBirth, DateTime referenceDate)
+        {
+            int years = referenceDate.Year - dateOfBirth.Year;
+
+            if (referenceDate.Month < dateOfBirth.Month 
+                || (referenceDate.Month == dateOfBirth.Month 
+                && referenceDate.Day < dateOfBirth.Day))
+            {
+                --years;
+            }
+            
+            return years;
+        }
+
+        /// <summary>
+        /// Returns the number of days in the month of the provided date.
+        /// </summary>
+        /// <param name="date">The date.</param>
+        /// <returns>The number of days.</returns>
+        public static int GetCountDaysOfMonth(this DateTime date)
+        {
+            var nextMonth = date.AddMonths(1);
+
+            return new DateTime(nextMonth.Year, nextMonth.Month, 1).AddDays(-1).Day;
+        }
+
+        /// <summary>
+        /// Returns the first day of the month of the provided date.
+        /// </summary>
+        /// <param name="date">The date.</param>
+        /// <returns>The first day of the month</returns>
+        public static DateTime GetFirstDayOfMonth(this DateTime date)
+        {
+            return new DateTime(date.Year, date.Month, 1);
+        }
+
+        /// <summary>
+        /// Returns the first day of the month of the provided date.
+        /// </summary>
+        /// <param name="date">The date.</param>
+        /// <param name="dayOfWeek">The desired day of week.</param>
+        /// <returns>The first day of the month</returns>
+        public static DateTime GetFirstDayOfMonth(this DateTime date, DayOfWeek dayOfWeek)
+        {
+            var dt = date.GetFirstDayOfMonth();
+
+            while (dt.DayOfWeek != dayOfWeek)
+            {
+                dt = dt.AddDays(1);
+            }
+
+            return dt;
+        }
+
+        /// <summary>
+        /// Returns the last day of the month of the provided date.
+        /// </summary>
+        /// <param name="date">The date.</param>
+        /// <returns>The last day of the month.</returns>
+        public static DateTime GetLastDayOfMonth(this DateTime date)
+        {
+            return new DateTime(date.Year, date.Month, GetCountDaysOfMonth(date));
+        }
+
+        /// <summary>
+        /// Returns the last day of the month of the provided date.
+        /// </summary>
+        /// <param name="date">The date.</param>
+        /// <param name="dayOfWeek">The desired day of week.</param>
+        /// <returns>The date time</returns>
+        public static DateTime GetLastDayOfMonth(this DateTime date, DayOfWeek dayOfWeek)
+        {
+            var dt = date.GetLastDayOfMonth();
+
+            while (dt.DayOfWeek != dayOfWeek)
+            {
+                dt = dt.AddDays(-1);
+            }
+
+            return dt;
+        }
+
+        /// <summary>
+        /// Indicates whether the date is today.
+        /// </summary>
+        /// <param name="dt">The date.</param>
+        /// <returns>
+        /// 	<c>true</c> if the specified date is today; otherwise, <c>false</c>.
+        /// </returns>
+        public static bool IsToday(this DateTime dt)
+        {
+            return (dt.Date == DateTime.Today);
+        }
+
+        /// <summary>
+        /// Sets the time on the specified DateTime value.
+        /// </summary>
+        /// <param name="date">The base date.</param>
+        /// <param name="hours">The hours to be set.</param>
+        /// <param name="minutes">The minutes to be set.</param>
+        /// <param name="seconds">The seconds to be set.</param>
+        /// <returns>The DateTime including the new time value</returns>
+        public static DateTime SetTime(this DateTime date, int hours, int minutes, int seconds)
+        {
+            return date.SetTime(new TimeSpan(hours, minutes, seconds));
+        }
+
+        /// <summary>
+        /// Sets the time on the specified DateTime value.
+        /// </summary>
+        /// <param name="date">The base date.</param>
+        /// <param name="time">The TimeSpan to be applied.</param>
+        /// <returns>
+        /// The DateTime including the new time value
+        /// </returns>
+        public static DateTime SetTime(this DateTime date, TimeSpan time)
+        {
+            return date.Date.Add(time);
+        }
+
+        /// <summary>
+        /// Converts a DateTime into a DateTimeOffset using the local system time zone.
+        /// </summary>
+        /// <param name="localDateTime">The local DateTime.</param>
+        /// <returns>The converted DateTimeOffset</returns>
+        public static DateTimeOffset ToDateTimeOffset(this DateTime localDateTime)
+        {
+            return localDateTime.ToDateTimeOffset(null);
+        }
+
+        /// <summary>
+        /// Converts a DateTime into a DateTimeOffset using the specified time zone.
+        /// </summary>
+        /// <param name="localDateTime">The local DateTime.</param>
+        /// <param name="localTimeZone">The local time zone.</param>
+        /// <returns>The converted DateTimeOffset</returns>
+        public static DateTimeOffset ToDateTimeOffset(this DateTime localDateTime, TimeZoneInfo localTimeZone)
+        {
+            localTimeZone = (localTimeZone ?? TimeZoneInfo.Local);
+
+            if (localDateTime.Kind != DateTimeKind.Unspecified)
+            {
+                localDateTime = new DateTime(localDateTime.Ticks, DateTimeKind.Unspecified);
+            }
+
+            return TimeZoneInfo.ConvertTimeToUtc(localDateTime, localTimeZone);
+        }
+
+        /// <summary>
+        /// Gets the first day of the week using the current culture.
+        /// </summary>
+        /// <param name="date">The date.</param>
+        /// <returns>The first day of the week</returns>
+        public static DateTime GetFirstDayOfWeek(this DateTime date)
+        {
+            return date.GetFirstDayOfWeek(null);
+        }
+
+        /// <summary>
+        /// Gets the first day of the week using the specified culture.
+        /// </summary>
+        /// <param name="date">The date.</param>
+        /// <param name="cultureInfo">The culture to determine the first weekday of a week.</param>
+        /// <returns>The first day of the week</returns>
+        public static DateTime GetFirstDayOfWeek(this DateTime date, CultureInfo cultureInfo)
+        {
+            cultureInfo = (cultureInfo ?? CultureInfo.CurrentCulture);
+
+            var firstDayOfWeek = cultureInfo.DateTimeFormat.FirstDayOfWeek;
+
+            while (date.DayOfWeek != firstDayOfWeek)
+            {
+                date = date.AddDays(-1);
+            }
+
+            return date;
+        }
+
+        /// <summary>
+        /// Gets the last day of the week using the current culture.
+        /// </summary>
+        /// <param name="date">The date.</param>
+        /// <returns>The first day of the week</returns>
+        public static DateTime GetLastDayOfWeek(this DateTime date)
+        {
+            return date.GetLastDayOfWeek(null);
+        }
+
+        /// <summary>
+        /// Gets the last day of the week using the specified culture.
+        /// </summary>
+        /// <param name="date">The date.</param>
+        /// <param name="cultureInfo">The culture to determine the first weekday of a week.</param>
+        /// <returns>The first day of the week</returns>
+        public static DateTime GetLastDayOfWeek(this DateTime date, CultureInfo cultureInfo)
+        {
+            return date.GetFirstDayOfWeek(cultureInfo).AddDays(6);
+        }
+
+        /// <summary>
+        /// Gets the next occurence of the specified weekday within the current week using the current culture.
+        /// </summary>
+        /// <param name="date">The base date.</param>
+        /// <param name="weekday">The desired weekday.</param>
+        /// <returns>The calculated date.</returns>
+        /// <example><code>
+        /// var thisWeeksMonday = DateTime.Now.GetWeekday(DayOfWeek.Monday);
+        /// </code></example>
+        public static DateTime GetWeeksWeekday(this DateTime date, DayOfWeek weekday)
+        {
+            return date.GetWeeksWeekday(weekday, null);
+        }
+
+        /// <summary>
+        /// Gets the next occurence of the specified weekday within the current week using the specified culture.
+        /// </summary>
+        /// <param name="date">The base date.</param>
+        /// <param name="weekday">The desired weekday.</param>
+        /// <param name="cultureInfo">The culture to determine the first weekday of a week.</param>
+        /// <returns>The calculated date.</returns>
+        /// <example><code>
+        /// var thisWeeksMonday = DateTime.Now.GetWeekday(DayOfWeek.Monday);
+        /// </code></example>
+        public static DateTime GetWeeksWeekday(this DateTime date, DayOfWeek weekday, CultureInfo cultureInfo)
+        {
+            var firstDayOfWeek = date.GetFirstDayOfWeek(cultureInfo);
+
+            return firstDayOfWeek.GetNextWeekday(weekday);
+        }
+
+        /// <summary>
+        /// Gets the next occurence of the specified weekday.
+        /// </summary>
+        /// <param name="date">The base date.</param>
+        /// <param name="weekday">The desired weekday.</param>
+        /// <returns>The calculated date.</returns>
+        /// <example><code>
+        /// var lastMonday = DateTime.Now.GetNextWeekday(DayOfWeek.Monday);
+        /// </code></example>
+        public static DateTime GetNextWeekday(this DateTime date, DayOfWeek weekday)
+        {
+            while (date.DayOfWeek != weekday)
+            {
+                date = date.AddDays(1);
+            }
+
+            return date;
+        }
+
+        /// <summary>
+        /// Gets the previous occurence of the specified weekday.
+        /// </summary>
+        /// <param name="date">The base date.</param>
+        /// <param name="weekday">The desired weekday.</param>
+        /// <returns>The calculated date.</returns>
+        /// <example><code>
+        /// var lastMonday = DateTime.Now.GetPreviousWeekday(DayOfWeek.Monday);
+        /// </code></example>
+        public static DateTime GetPreviousWeekday(this DateTime date, DayOfWeek weekday)
+        {
+            while (date.DayOfWeek != weekday)
+            {
+                date = date.AddDays(-1);
+            }
+
+            return date;
+        }
+
+        #endregion
+    }
+}
\ No newline at end of file