---
name: "updateAstronomical"
mode: "api"
versionRequirements:
  - { name: "@ray-js/ray", version: "1.5.2" }
title: "updateAstronomical - 修改天文定时"
---

## updateAstronomical

> [VERSION] @ray-js/ray >= 1.5.2

### 描述

修改天文定时

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `params` | `IAstronomical` | 是 | 请求参数 |

### 返回值

类型: `Promise<boolean>`

是否成功修改天文定时

### 引用对象

##### `interface` IAstronomical

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `id` | `number` | 定时任务 ID |
| `bizId` | `string` | 设备或群组 ID |
| `bizType` | `number` | 资源类型。0：单设备。1：群组设备。 |
| `loops` | `string` | 周循环 |
| `dps` | `string` | DP 值 |
| `astronomicalType` | `number` | 日出日落类型 |
| `timezone` | `string` | 时区 |
| `date` | `string` | 定时日期 yyyyMMdd |
| `time` | `string` | 定时时间 |
| `offsetType` | `number` | 定时偏移执行类型 |
| `lat` | `number` | 经度 |
| `lon` | `number` | 纬度 |


### 示例代码

#### 基础用法

```ts
import { updateAstronomical } from '@ray-js/ray';

updateAstronomical({
  id: 8642566,
  astronomicalType: 1,
  bizId: 'vdevo160456552237748',
  bizType: 0,
  dps: { 1: true },
  lat: 30.300694,
  lon: 120.068634,
  loops: '1111111',
  offsetType: -1,
  time: '00:04',
  timezone: '+08:00',
}).then((response) => {
  console.log('修改结果:', response);
}).catch((err) => {
  console.error(err);
});
```