---
id: "P:cAlgo.API.ChartMouseEventArgs.TimeValue"
kind: "property"
type: "T:cAlgo.API.ChartMouseEventArgs"
url: "https://help.ctrader.com/ctrader-algo/references/EventArgs/ChartMouseEventArgs/TimeValue/"
---

> Documentation index for agents: https://help.ctrader.com/ctrader-algo/llms.txt · machine index: https://help.ctrader.com/ctrader-algo/api.json

# ChartMouseEventArgs.TimeValue

Member of [ChartMouseEventArgs](https://help.ctrader.com/ctrader-algo/references/EventArgs/ChartMouseEventArgs/index.md).

## TimeValue

Gets the time value on the X-axis where the mouse event occurs.

Environments: Desktop supported · CLI not supported · Cloud not supported.

- CLI: Never raised in the CLI: the events that pass it never fire there (ChartArea.MouseDown, ChartArea.MouseEnter, ChartArea.MouseLeave and more).
- Cloud: Never raised in the cloud: the events that pass it never fire there (ChartArea.MouseDown, ChartArea.MouseEnter, ChartArea.MouseLeave and more).

C#:

```csharp
public DateTime TimeValue {get;}
```

Python:

```python
chartMouseEventArgs.TimeValue: DateTime
```

### Returns

`DateTime` — 

### Examples

C#:

```csharp
protected override void OnStart()
{
    Chart.MouseDown += OnChartMouseDown;
}

private void OnChartMouseDown(ChartMouseEventArgs args)
{
    Chart.DrawVerticalLine("clickedTime", args.TimeValue, Color.Red);
    Print("Clicked at time {0}", args.TimeValue);
}
```

Python:

```python
def on_start(self):
    api.Chart.MouseDown += self.on_chart_mouse_down

def on_chart_mouse_down(self, args):
    api.Chart.DrawVerticalLine("clickedTime", args.TimeValue, Color.Red)
    api.Print(f"Clicked at time {args.TimeValue}")
```