CalculateETA 1.7.2

Suggested Alternatives

CalculateETA 2.1.0

Additional Details

CalculateETA 2.1.0 is now supporting multi-target frameworks.

There is a newer version of this package available.
See the version list below for details.
dotnet add package CalculateETA --version 1.7.2                
NuGet\Install-Package CalculateETA -Version 1.7.2                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="CalculateETA" Version="1.7.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add CalculateETA --version 1.7.2                
#r "nuget: CalculateETA, 1.7.2"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install CalculateETA as a Cake Addin
#addin nuget:?package=CalculateETA&version=1.7.2

// Install CalculateETA as a Cake Tool
#tool nuget:?package=CalculateETA&version=1.7.2                

CalculateETA

CalculateETA is a project to calculate estimated time to arrive on loops whether it is in single-thread or multi-thread applicatons.

CalcETA14

Check out on NuGet gallery

Description

CalculateETA has methods to calculate estimated time to finish on loops. It calculates left count of iteration and multiply it with avarage passed time on the loop. On multi-thread applications, it has internal counter that increases everytime methods works via using that calculating left count of loop and multiply it with avarage passed time on the loop.

CalculateETA is optimized for CPU-intense applications.

Listed Methods

Counter Process
ResetCounter()
ResetCounterUint()

Returns true (value was not zero and resetted) or false (value was zero already) value. (bool)

Single-thread methods

<sup>1</sup>

CalcETA(int? index, int? totalIndex, long? totalElapsedTimeInMs)
CalcETAUnsafe(int? index, int? totalIndex, long? totalElapsedTimeInMs)
CalcETA(uint? index, uint? totalIndex, long? totalElapsedTimeInMs)
CalcETAUnsafe(uint? index, uint? totalIndex, long? totalElapsedTimeInMs)

Returns null if any of parameter is null or returns estimated left time in milliseconds (long?)

  • int?/uint? index: Current index of loop. Index must not be zero.

  • int?/uint? totalIndex: Total index of loop.

  • long? totalElapsedTimeInMs: Passed time of loop in milliseconds.

<sup>2</sup>

CalcETA(int? index, int? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAUnsafe(int? index, int? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAHighDense(int? index, int? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAHighDenseUnsafe(int? index, int? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETA(uint? index, uint? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAUnsafe(uint? index, uint? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAHighDense(uint? index, uint? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAHighDenseUnsafe(uint? index, uint? totalIndex, long? totalElapsedTicks, long? frequency)

Returns null if any of parameter is null or returns estimated left time in milliseconds (long?)

  • int?/uint? index: Current index of loop. Index must not be zero.

  • int?/uint? totalIndex: Total index of loop.

  • long? totalElapsedTicks: Passed ticks of loop.

  • long? frequency: Tick of frequency. Frequency must not be zero.

<sup>3</sup>

CalcETA(int? index, int? totalIndex, TimeSpan? timeSpan)
CalcETAUnsafe(int? index, int? totalIndex, TimeSpan? timeSpan)
CalcETA(uint? index, uint? totalIndex, TimeSpan? timeSpan)
CalcETAUnsafe(uint? index, uint? totalIndex, TimeSpan? timeSpan)

Returns null if any of parameter is null or returns estimated left time in milliseconds (double?)

  • int?/uint? index: Current index of loop. Index must not be zero.

  • int?/uint? totalIndex: Total index of loop.

  • TimeSpan? timeSpan: Passed time of loop in TimeSpan format.

Multi-thread methods

<sup>4</sup>

CalcETA(int? totalIndex, long? totalElapsedTimeInMs)
CalcETAUnsafe(int? totalIndex, long? totalElapsedTimeInMs)
CalcETA(uint? totalIndex, long? totalElapsedTimeInMs)
CalcETAUnsafe(uint? totalIndex, long? TotalElapsedTimeInMs)

Returns null if any of parameter is null or returns estimated left time in milliseconds (long?)

  • int?/uint? index: Current index of loop. Index must not be zero.

  • long? totalElapsedTimeInMs: Passed time of loop in milliseconds.

<sup>5</sup>

CalcETA(int? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAUnSafe(int? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAHighDense(int? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAHighDenseUnsafe(int? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETA(uint? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAUnsafe(uint? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAHighDense(uint? totalIndex, long? totalElapsedTicks, long? frequency)
CalcETAHighDenseUnsafe(uint? totalIndex, long? totalElapsedTicks, long? frequency)

Returns null if any of parameter is null or returns estimated left time in milliseconds (long?)

  • int?/uint? index: Current index of loop. Index must not be zero.

  • long? totalElapsedTicks: Passed ticks of loop.

  • long? frequency: Tick of frequency. Frequency must not be zero.

<sup>6</sup>

CalcETA(int? totalIndex, TimeSpan? timeSpan)
CalcETAUnsafe(int? totalIndex, TimeSpan? timeSpan)
CalcETA(uint? totalIndex, TimeSpan? timeSpan)
CalcETAUnsafe(uint? totalIndex, TimeSpan? timeSpan)

Returns null if any of parameter is null or returns estimated left time in milliseconds (double?)

  • int?/uint? index: Current index of loop. Index must not be zero.

  • TimeSpan? timeSpan: Passed time of loop in TimeSpan format.

Visualization of output

TimeSpanETA(long? eTATimeInMs)
TimeSpanETAUnsafe(long eTATimeInMs)

Returns null if eTATimeInMs is null. Returns TimeSpan.Zero if etaTimeInMs is negative. Returns left time. Unsafe method returns left time directly on same format. (TimeSpan)

  • long?: Estimated time to finish in milliseconds.
NumberFormatETA(long? eTATimeInMs)
NumberFormatETAUnsafe(long? eTATimeInMs)

Returns "Uncalculatable" if eTATimeInMs is null, returns "Negative" if eTATimeInMs is negative, returns "Too long" if eTATimeInMs is for more than a day, returns left time in {hh:mm:ss}. Unsafe method returns left time on same format. (string)

  • long?: Estimated time to finish in milliseconds.
NameETA(long? eTATimeInMs)
NameETAUnsafe(long? eTATimeInMs)

Returns "Uncalculatable" if eTATimeInMs is null, returns "Negative" if eTATimeInMs is negative (string)

Returns {} second(s), {} minute(s) and {} second(s), {} hour(s) and {} minute(s), or {} day(s) and {} hour(s). Unsafe method returns left time directly on same format.

  • long?: Estimated time to finish in milliseconds.
NameETABetterVisual(long? eTATimeInMs)
NameETABetterVisualUnsafe(long? eTATimeInMs)

Returns "Uncalculatable" if eTATimeInMs is null, returns "Negative" if eTATimeInMs is negative (string)

Returns {} second/seconds, {} minute/minutes and {} second/seconds, {} hour/hours and {} minute/minutes, or {} day/days and {} hour/hours. Unsafe method returns left time directly on same format.

  • long?: Estimated time to finish in milliseconds.

Example Usage

public string CalcSingleThread(int? index, int? totalIndex, double? totalElapsedTimeInMs)
{
    return NameETA(CalcETA(index: index, totalIndex: totalIndex, totalElapsedTimeInMs: totalElapsedTimeInMs));
}
public string CalcMultiThread(uint? totalIndex, long? totalElapsedTicks)
{
    return NameETA(CalcETAHighDense(totalIndex: totalIndex, totalElapsedTicks: totalElapsedTicks));
}
Single-Thread
  • CalcETA<sup>1</sup>(5, 10, 1000) ⇒ (long)1000
  • CalcETA<sup>2</sup>(5, 20, 50000000, 10000000) ⇒ (long)15
  • CalcETA<sup>3</sup>(5, 20, new TimeSpan(0, 0, 1, 5) ⇒ (double)195
Multi-Thread
  • CalcETA<sup>4</sup>(10, 1000) ⇒ (long)1000
  • CalcETA<sup>5</sup>(20, 50000000, 10000000) ⇒ (long)15
  • CalcETA<sup>6</sup>(20, new TimeSpan(0, 0, 1, 5) ⇒ (double)195
Output
  • TimeSpanETA(90000) ⇒ (TimeSpan)00:01:30
  • NumberFormatETA(90000) ⇒ "0:1:30"
  • NameETA(90000) ⇒ "1 minute(s) and 30 second(s)" (recommended for high-CPU-intense algorithm)
  • NameETABetterVisual(90000) ⇒ "1 minute and 30 seconds"(recommended for low-CPU-intense algorithm in order to offer better visual output)

Version History

See commit change See release history See changelog

  • 1.7.1

    • Methods are sorted and splited into three (Single-thread, multi-thread and common visual formatting).
    • Internal parameters naming fixed to avoid confusion.
    • Comments are improved to describe reason of usage better.
  • 1.7.0

    • CalcETAHighDense(int, uint), CalcETAHighDenseUnsafe(int, uint) methods are added. Among available methods for CPU-intense applications, new four methods can be used for precision on fast iterations.
  • 1.6.2

    • NumberFormatETA() and NumberFormatETAUnsafe() methods no longer return milliseconds as a part of return string.
    • NumberFormatETA() now returns "Too long" if input parameter value causes calculations for more than a day.
  • 1.6.1

    • Added missing return summaries.
    • Added warning for frequency parameter should be provided with ticksPerMilliseconds.
    • Fixed calculations on CalcETA(int, int timeSpan), CalcETA(uint,uint, timeSpan), CalcETAUnsafe(int, int, timeSpan) and CalcETAUnsafe(uint, uint, timeSpan).
    • Fixed wrong parameter name on methods that use totalElapsedTicks and frequency as parameters.
  • 1.6.0

    • Added TimeSpanETAUnsafe(), NumberFormatETAUnsafe(), NameETAUnsafe() and NameETABetterVisualUnsafe() methods.
    • totalSeconds variables renamed into elapsedSeconds.
    • Additional checking is added for value check of index and frequency on available safe methods.
  • 1.5.0

    • Added comments to every lines of code.

    • Added DivideByZeroException to methods when input parameter index is not longer being checkes for it was zero.

    • CalcETA() and CalcETAUnsafe() methods, now using nullable parameters.

    • CalcETA() methods checks if given parameters are null instead of 0 value.

    • CalcETA(..., long tickFrequency) method is now using CalcETA(..., long? frequency)

    • avarageElapsedTime varaiable is renamed into avarageElapsedTimeInMs.

    • seconds variable is renamed into elapsedSeconds.

    • TimeSpanETA() now returns null instead of TimeSpan.Zero when input parameter is null instead of it is zero value.

    • TimeSpanETA(), NumberFormatETA(), NameETA(), NameETABetterVisual() now uses new TimeSpan(ticks: ) instead of new TimeSpan(0,0,0,0, milliseconds: (int)eTATimeInMs)

    • NameETA() and NameETABetterVisual() are no longer returning result as $"{etaTimeInMs:0} ms" if input parameters is shorter then a second.

  • 1.4.0

    • Added NameETABetterVisual() method for offer better visual output
  • 1.3.0

    • Added support for uint data type as parameters.
    • Added unsafe methods for increase performance
  • 1.2.1

    • Output folder is renamed as OutputDLL
    • Ready-to-use CalculateETA.dll and CalculateETA.xml are updated.
  • 1.2.0

    • Fixed left time measurement bug.
    • When calculation left time TimeSpan is being used instead of conventional mathematical operations.
  • 1.1.0

    • Added ResetCounter() method for reset counter that holds int variable to calculate ETA on multi-thread applications
  • 1.0.0 Initial Release

Task list

Licence

No licence is required.

Authors

Twitter: Enes Okullu @enesokullu

Help

Twitter: Enes Okullu @enesokullu

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.1 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETCoreApp 3.1

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

v1.7.2 Icon added.