Calculator guide · Editorial

Timecode Calculator

The Timecode Calculator does arithmetic on timecode and converts between timecode and frame counts. It replaces the separate Frames to Timecode and Timecode to Frames calculators.

This help describes CineMath 1.3, the next update. Until it reaches the App Store, the version there is 1.2.1, and some screens, calculators and shortcuts differ. What changes in 1.3

Try it free in your browser

What you enter

InputWhat it is
Frame RateDefaults to 23.976 fps. The picker has 18 rates from 23.976 to 240 fps, including 29.970 and 59.940 fps DF, or a custom rate (always non-drop).
Operation+ Add (the default), − Subtract, × Multiply, ÷ Divide, Frames → TC or TC → Frames.
First TimecodeThe timecode you start from. Called Start Timecode in Frames → TC and TC → Frames.
Second TimecodeAdd and Subtract: the timecode to add or take away.
FactorMultiply and Divide: the number to multiply or divide by, such as 0.5, 2 or 24. Defaults to 1.
Frame CountFrames → TC: how many frames to add to the start timecode.
Convert TimecodeTC → Frames: the timecode to count frames up to from the start timecode.

Settings › Timecode › Format decides what happens past 24 hours. Time of Day (the default) wraps results, so 23:00:00:00 + 02:00:00:00 is 01:00:00:00, and hours stop at 23. Freerun does not wrap: the same sum is 25:00:00:00.

What you get

  • Add, Subtract, Multiply and Divide: the result timecode, Total frames, Duration in seconds and the frame rate. Multiply and Divide round to the nearest frame.
  • Frames → TC: the end timecode and the frames added.
  • TC → Frames: the number of frames from the start timecode to the convert timecode, with the start and end frame counts.
  • Drop-frame results use a semicolon before the frames (01:00:00;00).
  • A warning when Subtract would go below zero. The result shows 00:00:00:00 rather than wrapping round.
Formula
Frames = ((hours × 60 + minutes) × 60 + seconds) × timecode base + frames

The timecode base is the rate rounded to a whole number: 24 for 23.976, 30 for 29.97. Duration converts frames to real seconds at the actual rate, so one hour of 23.976 timecode is 3,603.60 seconds.

Worked examples

RateOperationInputsResult
24Add00:10:00:12 + 00:05:30:2000:15:31:08 (22,352 frames)
24Subtract01:45:22:15 − 01:38:07:0800:07:15:07
24Divide02:00:00:00 ÷ 600:20:00:00
23.976Frames → TC00:00:00:00 + 86,400 frames01:00:00:00 (3,603.60 s)
29.97 DFAdd00:50:00;00 + 00:10:00;0001:00:00;00

Step by step: the length of a scene from its in and out points

  1. Open the Timecode Calculator and set Frame Rate to your timeline rate.
  2. Operation: − Subtract.
  3. First Timecode: the out point. Second Timecode: the in point.
  4. The result is the duration; Total frames gives the same length as a frame count.

Known issue: frame counts at drop-frame rates

In CineMath 1.3, timecode results are correct at 29.97 and 59.94 DF, but two frame counts are not:

  • TC → Frames counts drop-frame timecode as if it were non-drop. 00:00:00;00 to 01:00:00;00 at 29.97 DF shows 108,000 frames; the right answer is 107,892.
  • After Add or Subtract at a DF rate, the Total frames and Duration lines have the same error, although the result timecode itself is right.

Until a fix ships, subtract the dropped frames yourself: at 29.97 DF, 2 frames for every whole minute except every tenth (00, 10, 20…), which is 18 frames per 10 minutes and 108 per hour. At 59.94 DF it is 4 per minute, 216 per hour. Frames → TC is not affected.

Gotchas

  • Drop-frame skips timecode labels, not frames of picture. 29.97 video plays 107,892 frames in a clock hour, so non-drop timecode reads only about 00:59:56:12 after a real hour. Drop-frame leaves out 108 labels an hour, so its hour, 107,892 frames, lasts 3,599.996 seconds: a clock hour to within a few milliseconds.
  • 23.976 has no drop-frame. Its timecode counts 24 labels a second, so one hour of timecode runs 3.6 seconds longer than a clock hour.
  • TC → Frames counts from the start timecode to the convert timecode, not including the last frame. For a clip’s inclusive frame count, add one.
  • Pick the rate before typing timecodes: the highest frame number allowed depends on it. At a DF rate, a label that drop-frame skips, such as 00:01:00;00, is read as the next one that exists, 00:01:00;02.

To retime a clip to a set length, use Target Length.