# Data Type Converter

> 数据类型转换工具。转换数据字段的类型，支持数值、字符串、日期等类型互转。 当用户提到类型转换、数据格式转换、字段类型修改等需求时使用此skill。 即使用户没有明确说出"类型转换"，只要任务涉及改变字段的数据类型，就应该使用此skill。

- Skill: `cas-bigdatalab/data-type-converter` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add cas-bigdatalab/data-type-converter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cas-bigdatalab/data-type-converter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cas-bigdatalab (https://skillmd.com/u/cas-bigdatalab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cas-bigdatalab/data-type-converter

---


# Data Type Converter 数据类型转换 Skill

## 功能概述

本skill用于转换数据字段的类型，支持：
- **数值转换**：int, float
- **字符串转换**：str
- **日期转换**：datetime
- **布尔转换**：bool
- **分类转换**：category

## 触发条件

当用户请求以下任务时，应使用此skill：
- 数据类型转换
- 字段格式转换
- 日期格式化
- 数值格式化

## 支持的目标类型

| 类型 | 说明 | 示例 |
|------|------|------|
| `int` | 整数 | "123" → 123 |
| `float` | 浮点数 | "123.45" → 123.45 |
| `str` | 字符串 | 123 → "123" |
| `datetime` | 日期时间 | "2024-01-01" → datetime |
| `bool` | 布尔值 | "true" → True |
| `category` | 分类类型 | 优化内存 |

## 使用方法

### 基本类型转换
```bash
python scripts/run_data_type_converter.py \
  --input data.csv \
  --output converted.csv \
  --conversions "age:int,score:float,name:str"
```

### 日期类型转换
```bash
python scripts/run_data_type_converter.py \
  --input data.csv \
  --output converted.csv \
  --conversions "date:datetime" \
  --date_format "%Y-%m-%d"
```

### 多字段转换
```bash
python scripts/run_data_type_converter.py \
  --input data.csv \
  --output converted.csv \
  --conversions "id:int,amount:float,date:datetime,category:category"
```

## 参数说明

| 参数 | 必填 | 说明 |
|------|------|------|
| `--input` | 是 | 输入文件路径 |
| `--output` | 是 | 输出文件路径 |
| `--conversions` | 是 | 转换规则 |
| `--date_format` | 否 | 日期格式，默认"%Y-%m-%d" |
| `--errors` | 否 | 错误处理，默认"coerce" |

## 错误处理方式

| 方式 | 说明 |
|------|------|
| `raise` | 遇到错误时抛出异常 |
| `coerce` | 转换失败设为NaN |
| `ignore` | 保留原值 |

## 输出示例

```
[OK] Data type conversion completed!
   Input file: data.csv
   Output file: converted.csv
   Conversions:
     - age: object → int64
     - score: object → float64
     - date: object → datetime64[ns]
   Total rows: 1000
   Conversion errors: 5
```

## 环境要求

```bash
pip install pandas numpy openpyxl
```