ArcGIS Pro 3.4 API Reference Guide
ArcGIS.Desktop.Mapping Namespace / TimeRange Class
Members Example Version

TimeRange Class
Represents an extent of time defined by a start and an end time.
Object Model
TimeRange ClassTimeRange ClassTimeReference Class
Syntax
public class TimeRange 
Remarks
TimeRange contains two properties Start and End which defines an extent of time. Either property can be set to null. When Start is null it means the time range begins infinite in the past and when End is null this means it ends infinite in the future. This is useful for example when setting the MapView.Time property to show all time before a given date, all time after a given date or to just show all time.
Example
Step forward in time by 1 month
public void StepMapTime()
{
  //Get the active view
  MapView mapView = MapView.Active;
  if (mapView == null)
    return;

  //Step current map time forward by 1 month
  TimeDelta timeDelta = new TimeDelta(1, TimeUnit.Months);
  mapView.Time = mapView.Time.Offset(timeDelta);
}
Interpolate Time
public Task<List<TimeRange>> GetInterpolatedMapTimes()
{
  //Return the collection representing the map time for each frame in animation.
  return QueuedTask.Run(() =>
  {
    var mapView = MapView.Active;
    if (mapView != null || mapView.Animation == null)
      return null;

    var animation = mapView.Map.Animation;

    var timeRanges = new List<TimeRange>();
    //We will use ticks here rather than milliseconds to get the highest precision possible.
    var ticksPerFrame = Convert.ToInt64(animation.Duration.Ticks / (animation.NumberOfFrames - 1));
    for (int i = 0; i < animation.NumberOfFrames; i++)
    {
      var time = TimeSpan.FromTicks(i * ticksPerFrame);
      //Because of rounding for ticks the last calculated time may be greating than the duration.
      if (time > animation.Duration)
        time = animation.Duration;
      timeRanges.Add(mapView.Animation.GetCurrentTimeAtTime(time));
    }
    return timeRanges;
  });
}
Inheritance Hierarchy

System.Object
   ArcGIS.Desktop.Mapping.TimeRange

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.
See Also