C# TimeSpan.FromMinutes() 메서드 완벽 정리 – 문법과 실전 예제

C#의 TimeSpan.FromMinutes() 메서드는 지정한 분(minute) 수를 나타내는 TimeSpan 객체를 반환합니다. 이때 분 단위 값은 밀리초까지의 정밀도로 표현할 수 있어, 소수점을 포함한 시간 간격 계산에 유용하게 활용됩니다.

문법(Syntax)

public static TimeSpan FromMinutes (double val);

매개변수 val은 분 단위의 값이며, 밀리초까지 정확하게 지정할 수 있습니다. 반환되는 TimeSpan은 해당 분 수에 해당하는 시간 간격을 담고 있습니다.

예제 1

아래 예제에서는 FromHours(), FromMilliseconds(), FromMinutes() 등 다양한 메서드로 TimeSpan을 생성한 뒤, TimeSpan.Compare() 메서드로 두 TimeSpan 값을 서로 비교합니다.

using System;
public class Demo {
   public static void Main() {
      TimeSpan span1 = TimeSpan.FromHours(0.78787);
      TimeSpan span2 = new TimeSpan(10, 30, 40);
      TimeSpan span3 = TimeSpan.FromHours(5);
      TimeSpan span4 = TimeSpan.FromMilliseconds(1);
      TimeSpan span5 = TimeSpan.FromMinutes(100);
      Console.WriteLine("TimeSpan1 = "+span1);
      Console.WriteLine("TimeSpan2 = "+span2);
      Console.WriteLine("TimeSpan3 = "+span3);
      Console.WriteLine("TimeSpan4 = "+span4);
      Console.WriteLine("TimeSpan5 = "+span5);
      Console.WriteLine("Result (Comparison of span1 and span2) = "+TimeSpan.Compare(span1, span2));
      Console.WriteLine("Result (Comparison of span2 and span3) = "+TimeSpan.Compare(span2, span3));
      Console.WriteLine("Result (Comparison of span1 and span3) = "+TimeSpan.Compare(span1, span3));
      Console.WriteLine("Result (Comparison of span3 and span4) = "+TimeSpan.Compare(span3, span4));
      Console.WriteLine("Result (Comparison of span4 and span5) = "+TimeSpan.Compare(span4, span5));
   }
}

출력 결과

TimeSpan1 = 00:47:16.3320000
TimeSpan2 = 10:30:40
TimeSpan3 = 05:00:00
TimeSpan4 = 00:00:00.0010000
TimeSpan5 = 01:40:00
Result (Comparison of span1 and span2) = -1
Result (Comparison of span2 and span3) = 1
Result (Comparison of span1 and span3) = -1
Result (Comparison of span3 and span4) = 1
Result (Comparison of span4 and span5) = -1

참고: TimeSpan.Compare() 메서드는 첫 번째 인자가 두 번째 인자보다 작으면 -1, 크면 1, 같으면 0을 반환합니다.

예제 2

이번에는 FromMinutes() 메서드에 200분과 150분을 전달하여 결과를 확인하고, 다른 방식으로 생성한 TimeSpan들과 비교해 보겠습니다.

using System;
public class Demo {
   public static void Main() {
      TimeSpan span1 = TimeSpan.FromMinutes(200);
      TimeSpan span2 = new TimeSpan(20, 10, 15);
      TimeSpan span3 = TimeSpan.FromHours(.78);
      TimeSpan span4 = TimeSpan.FromMilliseconds(1);
      TimeSpan span5 = TimeSpan.FromMinutes(150);
      Console.WriteLine("TimeSpan1 = "+span1);
      Console.WriteLine("TimeSpan2 = "+span2);
      Console.WriteLine("TimeSpan3 = "+span3);
      Console.WriteLine("TimeSpan4 = "+span4);
      Console.WriteLine("TimeSpan5 = "+span5);
      Console.WriteLine("Result (Comparison of span1 and span2) = "+TimeSpan.Compare(span1, span2));
      Console.WriteLine("Result (Comparison of span2 and span3) = "+TimeSpan.Compare(span2, span3));
      Console.WriteLine("Result (Comparison of span1 and span3) = "+TimeSpan.Compare(span1, span3));
      Console.WriteLine("Result (Comparison of span3 and span4) = "+TimeSpan.Compare(span3, span4));
      Console.WriteLine("Result (Comparison of span4 and span5) = "+TimeSpan.Compare(span4, span5));
   }
}

출력 결과

TimeSpan1 = 03:20:00
TimeSpan2 = 20:10:15
TimeSpan3 = 00:46:48
TimeSpan4 = 00:00:00.0010000
TimeSpan5 = 02:30:00
Result (Comparison of span1 and span2) = -1
Result (Comparison of span2 and span3) = 1
Result (Comparison of span1 and span3) = 1
Result (Comparison of span3 and span4) = 1
Result (Comparison of span4 and span5) = -1

출력 결과에서 볼 수 있듯이, FromMinutes(200)은 200분을 자동으로 3시간 20분(03:20:00)으로 변환하고, FromMinutes(150)은 2시간 30분(02:30:00)으로 변환합니다. 이처럼 TimeSpan.FromMinutes()를 사용하면 분 단위 값을 손쉽게 TimeSpan 형식으로 다룰 수 있습니다.