DateTimeOffset.AddMinutes() Method in C#

The DateTimeOffset.AddMinutes() method in C# adds a specified number of whole and fractional minutes to a DateTimeOffset instance. This method returns a new DateTimeOffset object with the updated time while preserving the original offset from UTC.

The method is particularly useful when working with time-zone aware calculations, as it maintains the timezone offset information throughout the operation.

Syntax

Following is the syntax −

public DateTimeOffset AddMinutes(double minutes);

Parameters

• minutes − A double value representing the number of minutes to add. Can be positive (to add) or negative (to subtract). Fractional values are allowed.

Return Value

Returns a new DateTimeOffset object whose value is the sum of the date and time represented by this instance and the number of minutes represented by minutes.

Adding Minutes to DateTimeOffset

Example

using System;

public class Demo {
   public static void Main() {
      DateTimeOffset dateTimeOffset = new DateTimeOffset(2019, 08, 10, 4, 20, 10, new TimeSpan(-5, 0, 0));
      Console.WriteLine("DateTimeOffset (before adding minutes) = {0}", dateTimeOffset);
      
      DateTimeOffset res = dateTimeOffset.AddMinutes(15);
      Console.WriteLine("DateTimeOffset (after adding minutes) = {0}", res);
   }
}

The output of the above code is −

DateTimeOffset (before adding minutes) = 8/10/2019 4:20:10 AM -05:00
DateTimeOffset (after adding minutes) = 8/10/2019 4:35:10 AM -05:00

Subtracting Minutes from DateTimeOffset

Example

using System;

public class Demo {
   public static void Main() {
      DateTimeOffset dateTimeOffset = new DateTimeOffset(2019, 08, 10, 4, 20, 10, new TimeSpan(-5, 0, 0));
      Console.WriteLine("DateTimeOffset (before subtracting minutes) = {0}", dateTimeOffset);
      
      DateTimeOffset res = dateTimeOffset.AddMinutes(-15);
      Console.WriteLine("DateTimeOffset (after subtracting minutes) = {0}", res);
   }
}

The output of the above code is −

DateTimeOffset (before subtracting minutes) = 8/10/2019 4:20:10 AM -05:00
DateTimeOffset (after subtracting minutes) = 8/10/2019 4:05:10 AM -05:00

Using Fractional Minutes

Example

using System;

public class Demo {
   public static void Main() {
      DateTimeOffset dateTimeOffset = new DateTimeOffset(2019, 08, 10, 4, 20, 10, new TimeSpan(-5, 0, 0));
      Console.WriteLine("Original DateTimeOffset = {0}", dateTimeOffset);
      
      DateTimeOffset result1 = dateTimeOffset.AddMinutes(2.5); // 2 minutes 30 seconds
      Console.WriteLine("After adding 2.5 minutes = {0}", result1);
      
      DateTimeOffset result2 = dateTimeOffset.AddMinutes(-1.25); // subtract 1 minute 15 seconds
      Console.WriteLine("After subtracting 1.25 minutes = {0}", result2);
   }
}

The output of the above code is −

Original DateTimeOffset = 8/10/2019 4:20:10 AM -05:00
After adding 2.5 minutes = 8/10/2019 4:22:40 AM -05:00
After subtracting 1.25 minutes = 8/10/2019 4:18:55 AM -05:00

Conclusion

The DateTimeOffset.AddMinutes() method provides a simple way to perform minute-based arithmetic on date-time values while preserving timezone information. It supports both positive and negative values, including fractional minutes, making it versatile for various time calculation scenarios.