DotnetTimecode 3.1.1

dotnet add package DotnetTimecode --version 3.1.1                
NuGet\Install-Package DotnetTimecode -Version 3.1.1                
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="DotnetTimecode" Version="3.1.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add DotnetTimecode --version 3.1.1                
#r "nuget: DotnetTimecode, 3.1.1"                
#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 DotnetTimecode as a Cake Addin
#addin nuget:?package=DotnetTimecode&version=3.1.1

// Install DotnetTimecode as a Cake Tool
#tool nuget:?package=DotnetTimecode&version=3.1.1                

Image of a non drop frame timecode.

What is Dotnet Timecode?

CI NuGet Nuget CodeQL

Dotnet Timecode is a C# class library for working with SMPTE Timecodes defined by the Society of Motion Picture and Television Engineers in the SMPTE 12M specification.

The library allows the user to construct timecode objects, manipulate timecode values, and convert between the most common framerates, including drop frame framerates such as 29.97DF and 59.95DF.

How do I get started?

Get the latest nuget package using the dotnet CLI

dotnet add package DotnetTimecode

or using the Nuget Package Manager

Install-Package DotnetTimecode

Add a reference to the library, then simply construct your objects.

Examples:

using DotnetTimecode;
using DotnetTimecode.Enums;

ITimecode foo = new Timecode(Framerate.fps30);
ITimecode bar = new Timecode(10, 00, 00, 00, Framerate.fps59_94_DF);
ITimecode baz = new Timecode("10:00:00:00", Framerate.fps24);

foo.ToString() // "00:00:00:00"
bar.AddMinutes(-61).ToString(); // "08:59:00;00"
baz.ConvertFramerate(Framerate.fps25).ToString(); // "09:36:00:00"

Public endpoints

Constructors

Timecode(Enums.Framerate framerate);
Timecode(int hour, int minute, int second, int frame, Enums.Framerate framerate);
Timecode(string timecode, Enums.Framerate framerate);

Object methods

timecodeObj.AddHours(int hours);
timecodeObj.AddMinutes(int minutes);
timecodeObj.AddSeconds(int seconds);
timecodeObj.AddFrames(int frames);
timecodeObj.ConvertFramerate(Enums.Framerate targetFramerate);
string timecodeString = timecodeObj.ToString();
string subtitleTimecodeString = timecodeObj.ToSubtitleString();

Static methods

string timecodeString = Timecode.AddHours(timecodeString, hoursInteger);
string timecodeString = Timecode.AddMinutes(timecodeString, minutesInteger);
string timecodeString = Timecode.AddSeconds(timecodeString, secondsInteger);
string timecodeString = Timecode.AddFrames(timecodeString, framesInteger);
string timecodeString = Timecode.ConvertFramerate(timecodeString, originalFramerateEnum, targetFramerateEnum);
string timecodeString = Timecode.ConvertSMPTETimecodeToSubtitleTimecode(srtTimecodeString, framerateEnum);
string subtitleTimecodeString = Timecode.ConvertSubtitleTimecodeToSMPTETimecode(timecodeString, framerateEnum);

Object Properties

int hour = timecodeObj.Hour;
int minute = timecodeObj.Minute;
int second = timecodeObj.Second;
int frame = timecodeObj.Frame;
int totalFrames = timecodeObj.TotalFrames;
Enums.Framerate framerate = timecodeObj.Framerate;

Static Properties

string timecodeRegex = Timecode.TimecodeRegexPattern;
string subtitleTimecodeRegex = Timecode.SubtitleTimecodeRegexPattern;

Operator Overloading

ITimecode timecodeObj1 = new Timecode(10, 0, 0, 0, Enums.Framerate.fps23_976); // 10:00:00:00
ITimecode timecodeObj2 = new Timecode(1, 0, 0, 0, Enums.Framerate.fps23_976); // 01:00:00:00

timecodeObj1 + timecodeObj2;  // 11:00:00:00
timecodeObj1 - timecodeObj2;  // 09:00:00:00
timecodeObj1 < timecodeObj2;  // False
timecodeObj1 > timecodeObj2;  // True
timecodeObj1 <= timecodeObj2; // False
timecodeObj1 >= timecodeObj2; // True
timecodeObj1 == timecodeObj2; // False
timecodeObj1 != timecodeObj2; // True

Contributions

How to contribute to the project

See CONTRIBUTING.md and CODE_OF_CONDUCT.md for instructions on how to contribute to the project.

License

Dotnet Timecode is Copyright © 2022 Rasmus Broborg and other contributors under the MIT license.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net6.0

    • 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.

Version Downloads Last updated
3.1.1 1,016 10/8/2023
3.1.0 781 11/21/2022
3.0.1 540 11/21/2022
3.0.0 556 11/21/2022
2.0.1 612 11/11/2022
2.0.0 518 11/11/2022
1.2.1 610 9/27/2022
1.1.2 667 9/27/2022
1.1.1 617 9/27/2022
1.0.0 649 9/27/2022

Adds support for non drop framerates, srt timecodes, static operations, XML comments, operator overloading.