# Metadata
Platforms: desktop, server OS: mac, windows, linux Introduced: 1.0 Security:
# Syntax
currentTimeChanged pNewTime
# Params
- pNewTime : The number of the interval where the player is after the change.
# Examples
on currentTimeChanged theInterval -- display the time in a field put theInterval into field "Time Code" end currentTimeChanged
# Description
The currentTimeChanged message is sent while the player is playing or when a user changes the current time in a player.
Handle the currentTimeChanged message if you want to do something when the user changes the current time in a player.
The user can change the current time by:
- clicking the play button in the controller bar, - clicking in the controller bar, - dragging the controller bar scroller thumb, - using the arrow keys when the player is the active (focused) control, - using the scrubber control in the controller bar. (which is revealed by clicking the arrow buttons in the controller bar while holding the shift key down.)
Changing the player's currenttime property property by script does not trigger the sending of the currentTimeChanged message.
Changing the player's currenttime property property by script does not trigger the sending of the currentTimeChanged message.
Starting the player by script does trigger the sending of the currentTimeChanged message once it is playing.
The number of intervals per second is specified by the player's timeScale property. The total number of intervals is given in the player duration property.
The actual process of changing the player's current time is not triggered by the currentTimeChanged message, so trap the message and not allowing it to pass does not prevent the user from changing the player current time manually.
# Tags
# See
- **keyword:** player - **property:** callbacks, duration - **message:** playStarted, playPaused, selectionChanged - **object:** player - **glossary:** property, player, message, frame, trap - **control structure:** pass