japanese-fullhalf-convert

A JavaScript package for converting Japanese characters between full-width (全角) and half-width (半角) formats.

Features

- Convert full-width Katakana to half-width Katakana (カタカナ ↔ ｶﾀｶﾅ)
- Convert full-width numbers to half-width numbers (１２３ ↔ 123)
- Convert full-width punctuation and symbols to half-width
- Convert full-width spaces to half-width spaces
- Bidirectional conversion support

Installation

$3

``bash
npm install japanese-fullhalf-convert
`

$3

`html






`

$3

`javascript
import { toHalfWidth, toFullWidth } from 'japanese-fullhalf-convert';
`

Usage

$3

`javascript
const { toHalfWidth, toFullWidth } = require('japanese-fullhalf-convert');

// Convert full-width to half-width
const fullWidth = 'カタカナ１２３';
const halfWidth = toHalfWidth(fullWidth);
console.log(halfWidth); // Output: ｶﾀｶﾅ123

// Convert half-width to full-width
const halfWidth2 = 'ｶﾀｶﾅ123';
const fullWidth2 = toFullWidth(halfWidth2);
console.log(fullWidth2); // Output: カタカナ１２３

// Examples with different character types
console.log(toHalfWidth('ＨＥＬＬＯ')); // Output: HELLO
console.log(toFullWidth('hello')); // Output: ｈｅｌｌｏ
console.log(toHalfWidth('　')); // Full-width space -> half-width space
console.log(toFullWidth(' ')); // Half-width space -> full-width space
`

$3

`javascript
import { toHalfWidth, toFullWidth } from 'japanese-fullhalf-convert';

const result = toHalfWidth('カタカナ１２３');
console.log(result); // Output: ｶﾀｶﾅ123
`

$3

`html


`

$3

`html



`

API

$3

Converts full-width Japanese characters to half-width.

Parameters:
- str (string): Input string with full-width characters

Returns:
- (string): String with half-width characters

Example:
`javascript
toHalfWidth('カタカナ１２３'); // Returns: 'ｶﾀｶﾅ123'
`

$3

Converts half-width Japanese characters to full-width.

Parameters:
- str (string): Input string with half-width characters

Returns:
- (string): String with full-width characters

Example:
`javascript
toFullWidth('ｶﾀｶﾅ123'); // Returns: 'カタカナ１２３'
``

Supported Conversions

$3

- Full-width Katakana (ア-ン, ァ-ォ, ャ-ョ, ッ, ー) ↔ Half-width Katakana (ｱ-ﾝ, ｧ-ｫ, ｬ-ｮ, ｯ, ｰ)

$3

- Full-width numbers (０-９) ↔ Half-width numbers (0-9)

$3

- Full-width uppercase (Ａ-Ｚ) ↔ Half-width uppercase (A-Z)
- Full-width lowercase (ａ-ｚ) ↔ Half-width lowercase (a-z)

$3

- Full-width punctuation and symbols ↔ Half-width equivalents

$3

- Full-width space (　) ↔ Half-width space ( )

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.