Vali-Duration — Ejemplos

dotnet add package Vali-Duration

FromTimeSpan + Format — Medir el tiempo transcurrido con Stopwatch

Captura el tiempo transcurrido de una operación usando Stopwatch, envuélvelo en un ValiDuration y fórmatealo como una cadena legible para humanos.

using System;
using System.Diagnostics;
using Vali_Duration.Models;

var sw = Stopwatch.StartNew();

// Simular trabajo
long sum = 0;
for (int i = 0; i < 10_000_000; i++)
    sum += i;

sw.Stop();

ValiDuration elapsed = ValiDuration.FromTimeSpan(sw.Elapsed);

Console.WriteLine($"Raw milliseconds : {elapsed.TotalMilliseconds:F3} ms");
Console.WriteLine($"Formatted (0 dp) : {elapsed.Format()}");
Console.WriteLine($"Formatted (2 dp) : {elapsed.Format(2)}");
Console.WriteLine($"Sum result       : {sum}");
// Ejemplo de salida:
// Raw milliseconds : 18.472 ms
// Formatted (0 dp) : 18ms
// Formatted (2 dp) : 0.02 seconds
// Sum result       : 49999995000000

Pruébalo en vivo

▶ Abrir en dotnetfiddle — Agrega el paquete NuGet Vali-Duration en la configuración del fiddle.

---

Operadores aritméticos — Sumar y restar valores ValiDuration

Combina múltiples duraciones usando los operadores + y -, y escálalas con * y /.

using System;
using Vali_Duration.Models;

var meeting    = ValiDuration.FromMinutes(45m);
var break_     = ValiDuration.FromMinutes(15m);
var deepWork   = ValiDuration.FromHours(2m);

ValiDuration totalWork   = meeting + deepWork;          // 2h 45m
ValiDuration netWork     = totalWork - break_;          // 2h 30m
ValiDuration doubleShift = netWork * 2m;                // 5h
ValiDuration halfShift   = netWork / 2m;                // 1h 15m

Console.WriteLine($"Meeting + Deep work : {totalWork.Format()}");
Console.WriteLine($"Minus break         : {netWork.Format()}");
Console.WriteLine($"Double shift        : {doubleShift.Format()}");
Console.WriteLine($"Half shift          : {halfShift.Format()}");
// Salida:
// Meeting + Deep work : 2h 45m
// Minus break         : 2h 30m
// Double shift        : 5h
// Half shift          : 1h 15m

Pruébalo en vivo

▶ Abrir en dotnetfiddle — Agrega el paquete NuGet Vali-Duration en la configuración del fiddle.

---

As(TimeUnit) — Convertir a una unidad específica

Usa As(TimeUnit) para extraer la duración expresada como un decimal en cualquier unidad admitida.

using System;
using Vali_Duration.Models;
using Vali_Duration.Enums;

var sprint = ValiDuration.FromDays(14m);

decimal inHours   = sprint.As(TimeUnit.Hours);
decimal inMinutes = sprint.As(TimeUnit.Minutes);
decimal inWeeks   = sprint.As(TimeUnit.Weeks);

Console.WriteLine($"Sprint duration");
Console.WriteLine($"  Days    : {sprint.TotalDays}");
Console.WriteLine($"  Hours   : {inHours}");
Console.WriteLine($"  Minutes : {inMinutes}");
Console.WriteLine($"  Weeks   : {inWeeks}");

// Ejemplo de facturación — tarifa por hora
decimal hourlyRate    = 95m;
decimal billableHours = sprint.As(TimeUnit.Hours);
decimal totalAmount   = billableHours * hourlyRate;

Console.WriteLine($"Billing @ ${hourlyRate}/h : ${totalAmount:F2}");
// Salida:
// Sprint duration
//   Days    : 14
//   Hours   : 336
//   Minutes : 20160
//   Weeks   : 2
// Billing @ $95/h : $31920.00

Pruébalo en vivo

▶ Abrir en dotnetfiddle — Agrega el paquete NuGet Vali-Duration en la configuración del fiddle.

---

Operadores de comparación — Comparar duraciones

Los seis operadores de comparación (==, !=, <, <=, >, >=) funcionan directamente sobre valores ValiDuration.

using System;
using Vali_Duration.Models;

var workday   = ValiDuration.FromHours(8m);
var shortDay  = ValiDuration.FromHours(6m);
var overtime  = ValiDuration.FromHours(10m);
var anotherWD = ValiDuration.FromMinutes(480m); // igual que workday

Console.WriteLine($"shortDay  < workday   : {shortDay < workday}");
Console.WriteLine($"overtime  > workday   : {overtime > workday}");
Console.WriteLine($"workday  == anotherWD : {workday == anotherWD}");
Console.WriteLine($"shortDay != workday   : {shortDay != workday}");
Console.WriteLine($"overtime >= workday   : {overtime >= workday}");
Console.WriteLine($"shortDay <= workday   : {shortDay <= workday}");

var sessions = new[]
{
    ValiDuration.FromMinutes(90m),
    ValiDuration.FromHours(3m),
    ValiDuration.FromMinutes(45m),
};

foreach (var s in sessions)
{
    string label = s > workday   ? "OVERTIME"
                 : s == workday  ? "FULL DAY"
                 :                 "PARTIAL";
    Console.WriteLine($"  {s.Format()} => {label}");
}
// Salida:
// shortDay  < workday   : True
// overtime  > workday   : True
// workday  == anotherWD : True
// shortDay != workday   : True
// overtime >= workday   : True
// shortDay <= workday   : True
//   1h 30m => PARTIAL
//   3h => PARTIAL
//   45m => PARTIAL

Pruébalo en vivo

▶ Abrir en dotnetfiddle — Agrega el paquete NuGet Vali-Duration en la configuración del fiddle.