A newer version of this page is available. Switch to the current version.

TimeSpanEdit Class

The editor to display and edit time intervals.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v18.2.dll


[ToolboxBitmap(typeof(ToolboxIconsRootNS), "TimeSpanEdit")]
public class TimeSpanEdit :

The following members accept/return TimeSpanEdit objects:


A TimeSpanEdit editor is designed to visually represent data stored in the System.TimeSpan format. The editor contains the following visual elements (see the figure below):

TimeSpanEdit - Visual Elements

The following code illustrates how to display a time span obtained by subtracting one DateTime value from another.

namespace timespan {
    public partial class Form1 : XtraForm {
        DateTime NYDate = new DateTime(2015, 1, 1, 0, 0, 0, 0);
        public Form1() {
            timeSpanEdit1.Properties.DisplayFormat.FormatType = DevExpress.Utils.FormatType.Custom;
            timeSpanEdit1.Properties.DisplayFormat.FormatString = "{0:dd} days, {0:hh} hours, {0:mm} minutes and {0:ss} seconds";
            timeSpanEdit1.Properties.ReadOnly = false;
            timeSpanEdit1.Properties.Mask.EditMask = "dd:HH:mm:ss";

        private void RefreshTimer() {
            DateTime currentDate = DateTime.Now;
            TimeSpan timeToNY = NYDate - currentDate;
            timeSpanEdit1.EditValue = timeToNY;

        private void simpleButton1_Click(object sender, EventArgs e) {

        private void timeSpanEdit1_EditValueChanged(object sender, EventArgs e) {
            labelControl1.Text = timeSpanEdit1.Properties.GetDisplayText(timeSpanEdit1.EditValue) + " left for the New Year!";

TimeSpanEdit - New Year Counter

See Also